Deployments
| Tool | Permission | Purpose |
|---|---|---|
list_deployments | read | List queued, in-progress, or application deployment history. |
get_deployment | read | Inspect one deployment; build logs are not returned. |
deploy | deploy | Queue a deployment by uuid, or deploy every resource with a tag. Give one of them. A tag deploy needs confirm=true. Supports force rebuild, preview IDs, and cancel_previous. |
cancel_deployment | deploy | Cancel a queued or in-progress deployment. |
control | deploy | Start, stop, or restart an application, database, service, or one service application or database (service_uuid with uuid). stop requires confirm=true. |
list_rollback_images | read | List the images that an application can roll back to. |
rollback_application | deploy | Roll back an application to an earlier image. Requires confirm=true. |
Follow Security before granting deploy.
cancel_previous cancels older webhook, API, and MCP deployments of the same application, pull request, and server:
| Value | Effect |
|---|---|
none | Cancel nothing. This is the default. |
queued | Cancel queued deployments. |
building | Cancel queued deployments and deployments that are still building. |
A deployment that started to replace containers always finishes. Manual, restart, and rollback deployments are never cancelled.
Preview pull request IDs must be integers from 0 to 2147483647. 0 means no preview. Invalid IDs produce a validation error. See Preview deployments for the related API workflow.