Coolify logoCoolify
Cloud

API server

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

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

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

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

POST
/servers/import

Import a server transfer bundle into this Coolify instance (adopt mode by default).

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bundle?object

Plain or encrypted transfer bundle

passphrase?string|null
dry_run?boolean
Defaultfalse
preserve_uuids?boolean
Defaulttrue
adopt_mode?boolean

Import without forcing redeploy; keep statuses for adoption

Defaulttrue
claim?boolean

Automatically claim the host for this instance after import

Defaulttrue
write_remote?boolean

When claiming, write ownership file on the host via SSH

Defaultfalse
rebind_sentinel?boolean

When claiming, rebind Sentinel to this instance

Defaulttrue

Response Body

application/json

curl -X POST "https://app.coolify.io/api/v1/servers/import" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
{  "message": "Unauthenticated."}
Empty

Get Sentinel settings GET

Get Sentinel settings for a server owned by the authenticated team. sentinel_token and sentinel_custom_url require the read:sensitive or root token ability.

List Docker cleanup executions GET

List recent Docker cleanup execution logs for a server owned by the authenticated team.