Deploy

API server

https://app.coolify.io/api/v1

Deploy by tag or UUID using query parameters or a JSON body.

Authorization

bearerAuth

AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Query Parameters

tag?string

Tag name(s). Comma separated list is also accepted.

uuid?string

Resource UUID(s). Comma separated list is also accepted.

force?boolean

Force rebuild (without cache)

pr?integer

Pull Request Id for deploying specific PR builds. Cannot be used with tag parameter.

Rangevalue <= 2147483647

pull_request_id?integer

Preview deployment identifier. Alias of pr.

Rangevalue <= 2147483647

docker_tag?string

Docker image tag for Docker Image preview deployments. Requires pull_request_id.

cancel_previous?string

Cancel the older webhook, API, and MCP deployments of the same application, pull request, and server. queued cancels the ones that wait in the queue. building also stops the ones that are still building; a deployment that already started to replace containers always finishes. Manual, restart, and rollback deployments are never cancelled. Default: none.

Default"none"

Value in"none" | "queued" | "building"

Response Body

`application/json`

curl -X POST "https://app.coolify.io/api/v1/deploy"

{  "deployments": [    {      "message": "string",      "resource_uuid": "string",      "deployment_uuid": "string"    }  ]}

{  "message": "Invalid token."}

{  "message": "Unauthenticated."}

Deploy

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`