Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

Stop deployment

POST/v1/deployments/{deploymentId}/stopStop deployment

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

Requests VM shutdown for the deployment. The deployment record and metadata are retained. Poll the status endpoint until stopped is reached.

Parameters

deploymentIdstringpathrequired

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

Responses

204Stop request accepted.
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 running or provisioning to be stopped.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