Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

Delete deployment

DELETE/v1/deployments/{deploymentId}Delete deployment

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Permanently deletes the deployment, its metadata, and any associated VM. The deployment must be stopped or in the new state before it can be deleted.

Parameters

deploymentIdstringpathrequired

pattern ^(cpv_)?([cC][^\s-]{8,}|[a-z0-9]+)$

Responses

204Deployment deleted.
401Missing or invalid authorization token.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
403Insufficient permissions to access this resource.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
404Deployment not found.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
409The deployment must be stopped before it can be deleted.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
429Rate limit exceeded.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
Documentation menu