Coolify Octri Demo
POST/servers/{uuid}/migrate

Migrate a server to another instance

Starts a background transfer of a server to another instance by exporting it, importing and claiming it on the target, and then disabling automations on the source. Supply the target instance URL and token; the URL must use HTTPS. Follow the transfer progress with GET /servers/{uuid}/transfer.

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

1 parameter · 2 body fields
uuidstringrequired
The UUID of the server to transfer to another instance.

Target instance details required to start the server transfer.

target_tokenstringrequired
API token on the target instance (root or write)
target_urlstringrequired
HTTPS URL of the target instance.

4 status codes
202Returns confirmation that the server transfer was started in the background.
403Returned when the token lacks the sensitive permission.
404Returned when the server resource is not found.
messagestringoptional
422Returned when validation fails or the remote import fails.

Error handling

A 403 is returned when the token lacks the sensitive permission, and a 404 is returned when the server is not found. A 422 is returned when validation fails or the remote import fails. The uuid path parameter must identify the server to transfer, and target_url must use HTTPS.