Coolify logoCoolify
Cloud

Import server transfer bundle

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). This instance then manages the server, and Sentinel reports to it. Needs a token with the write and deploy permissions.

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

Transfer bundle

dry_run?boolean
Defaultfalse
preserve_uuids?boolean
Defaulttrue
adopt_mode?boolean

Import without forcing redeploy; keep statuses for adoption

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
Empty

Get server transfer status GET

Show the transfer state of a server on this instance: the import/claim state (transfer) and the state of a running or finished transfer to another instance (migration).

List Docker cleanup executions GET

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