Delete Deployment

DELETE /v1/deployments/:deployment_id

Stops the agent, tears down its container, and deletes the deployment. By default the persistent filesystem and memory are deleted with it.

Deletion is permanent. The agent’s workspace, memory, skills, and automations are destroyed unless you pass retain_filesystem=true.

Request

curl "https://api.prismagents.com/v1/deployments/dep_7xK9s2" \
  -X DELETE \
  -H "Authorization: Bearer $PRISM_API_KEY"

Parameter	Type	Required	Description
`deployment_id`	string	Yes	Deployment ID

Parameter	Type	Required	Description
`retain_filesystem`	boolean	No	Keep a snapshot of the workspace for 30 days. Defaults to `false`

{
  "deployment_id": "dep_7xK9s2",
  "status": "deleted"
}

Status	Error	When
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	API key lacks `deployments:write` scope
404	`not_found`	Deployment does not exist

See Errors for the full error reference.