v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Databases

Migrate a Database Cluster to a New Region

To migrate a database cluster to a new region, send a PUT request to /v2/databases/$DATABASE_ID/migrate. The body of the request must specify a region attribute.

A successful request will receive a 202 Accepted status code with no body in response. Querying the database cluster will show that its status attribute will now be set to migrating. This will transition back to online when the migration has completed.

put/v2/databases/{database_cluster_uuid}/migrate

Path parameters

database_cluster_uuidstring uuid required

A unique identifier for a database cluster.

Request body

regionstring required

A slug identifier for the region to which the database cluster will be migrated.

Example request

{
  "region": "lon1"
}

Response

This does not indicate the success or failure of any operation, just that the request has been accepted for processing.