Coolify Octri Demo
POST/databases/{uuid}/move

Move a database to another environment

Moves a database to another project or environment without affecting its running containers. Provide the target environment_uuid in the request body. After the move, the database picks up shared environment variables from the new environment on its next deployment.

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

1 parameter · 1 body field
uuidstringrequired
The UUID of the database to move.

Target environment for the database move. environment_uuid is required.

environment_uuidstringrequired
UUID of the target environment.

5 status codes
200Returns the database UUID, the target project and environment UUIDs, and a message confirming the move.
environment_uuidstringoptional
messagestringoptional
project_uuidstringoptional
uuidstringoptional
400Returned when the request contains an invalid token.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when a resource is not found.
messagestringoptional
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token, a 401 when the request is unauthenticated, a 404 when a resource is not found, and a 422 when the request fails validation. The uuid path parameter must identify the database, and environment_uuid is required to identify the target environment.