Skip to main content
DELETE
Requires version 2.0.1 or later of the Archetype platform.

Overview

This endpoint deletes a deployment that is stopped or failed and has no sessions left. To delete a deployment that is still ready, stop it first. Then delete each of its sessions with Delete Session; list them with List Sessions and deployment_id. With its deployments gone, a package can be deleted, and then its project.

Request

string
required
Deployment dpl_ id.

Response

Returns 204 No Content with an empty body on success.

Important Notes

  • A 409 means the deployment is not stopped or failed, or still has sessions.
  • A 403 means you can see the deployment’s project but cannot modify it.
  • A 404 means the deployment does not exist, belongs to another organization, or is in a project you cannot see.
  • Success returns 204 with no body. Check the status code rather than parsing a response.