Coolify Octri Demo
POST/servers/import

Import a server transfer bundle

Imports a server transfer bundle into this instance so the instance can manage the server and Sentinel can report to it. By default, import uses adopt mode, which preserves statuses without forcing a redeploy. Use dry_run to request a dry-run result before importing.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

4 body fields

Server transfer bundle and import options.

adopt_modebooleanoptional
Import without forcing redeploy; keep statuses for adoption
Default:true
bundleobjectoptional
Transfer bundle
dry_runbooleanoptional
Whether to return a dry-run result without importing. Defaults to false when omitted.
Default:false
preserve_uuidsbooleanoptional
Whether to preserve UUIDs from the transfer bundle. Defaults to true when omitted.
Default:true

5 status codes
200Returns the dry-run result.
201Returns confirmation that the server was imported.
401Returned when the request is unauthenticated.
messagestringoptional
403Returned when the token lacks the write and deploy permissions.
422Returned when validation fails.

Error handling

A 401 is returned when the request is unauthenticated. A 403 is returned when the token lacks the write and deploy permissions; a 422 is returned when validation fails. adopt_mode defaults to true, dry_run defaults to false, and preserve_uuids defaults to true when omitted.