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

Migrate to Server

Migrate a service to another destination/server owned by the authenticated team. Stops the service, optionally transfers persistent volume data when both servers are managed by Coolify, and updates database records. Redeploy after migration completes.

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

1 parameter · 2 body fields
uuidstringrequired
UUID of the service.
destination_uuidstringrequired
UUID of the target destination.
migrate_volumesbooleanoptional
Whether to transfer persistent volume data when migrating across servers.
Default:true

5 status codes
200Service migration started or completed.
400Invalid token.
messagestringoptional
401Unauthenticated.
messagestringoptional
404Resource not found.
messagestringoptional
422Validation error.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned: Invalid token. A 401 is returned: Unauthenticated. A 404 is returned: Resource not found. A 422 is returned: Validation error.