Deploy | Coolify Docs

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

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.

pull_request_id?integer

Preview deployment identifier. Alias of pr.

docker_tag?string

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

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

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

{  "message": "Invalid token."}

{  "message": "Unauthenticated."}