Provision a database

POST

/provision/databases

A managed sqlite database is built on Cloudflare D1 during the request,
and comes back active with somewhere to connect. Every other engine is
recorded as provisioning until something builds it.

Capability: resource:provision (area resource, on the database). With a team context: resource:provision in that team.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Created

Headers

Bodyapplication/json

🟠409

🟠400ValidationError

🟠402PlanLimit

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.prod-orm.io/provision/databases' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "description": "string",
    "type": "postgres",
    "size": 1,
    "managed": true,
    "region": "string",
    "localPoint": {
        "lat": -90,
        "lng": -180
    },
    "primaryPoint": {
        "lat": -90,
        "lng": -180
    },
    "version": "string",
    "roles": [
        {}
    ],
    "teamId": 1,
    "dedicated": false,
    "cpu": 1,
    "memory": 512
}'

Response Example

201 - Example 1

{
    "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

Every database on the account

Change a database that is already running