Change a database that is already running

PATCH

/provision/databases/{id}

Only what is ours to change without touching the engine: its name, what
it is for, where we think it is, what it says about itself. Size is not
here — growing a volume is work, and work is an operation. Nor is the
engine: that is not a field.

Capability: resource:operate (area resource, on the database).

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Updated

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.prod-orm.io/provision/databases/' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "description": "string",
    "region": "string",
    "version": "string",
    "roles": [
        {}
    ],
    "localPoint": {
        "lat": -90,
        "lng": -180
    },
    "primaryPoint": {
        "lat": -90,
        "lng": -180
    },
    "managed": true
}'

Response Example

{
    "database": {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "name": "string",
        "description": "string",
        "type": "string",
        "status": "provisioning",
        "managed": true,
        "region": "string",
        "size": 0,
        "sizeUnit": "2.00 GB",
        "usage": {
            "used": 0,
            "usedUnit": "1.70 GB",
            "usedPercent": "85%",
            "cpu": 0,
            "memory": 0,
            "connections": 0,
            "requests": 0,
            "lastUsedAt": "2019-08-24T14:15:22.123Z"
        },
        "localPoint": {
            "lat": -90,
            "lng": -180
        },
        "primaryPoint": {
            "lat": -90,
            "lng": -180
        },
        "primaryDistance": "6549 km",
        "version": "string",
        "roles": [
            {
                "name": "string",
                "privilege": "owner"
            }
        ],
        "provider": "cloudflare",
        "externalId": "string"
    }
}

Modified at 2026-10-05 14:01:12

Provision a database

One database