ReferenceAPI

Create a database

Create a managed Postgres database in a workspace and wait for it to come up.

POST https://api.nevia.cloud/v1/databases
curl -X POST "https://api.nevia.cloud/v1/databases" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: 8f1c2a7e-3b4d-4c5e-9f0a-1b2c3d4e5f60" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
    "name": "orders"
  }'
{
  "database": {
    "id": "01d4cnjkgq02b6tfqvy8yh391pq",
    "workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
    "name": "api-staging",
    "state": "ready",
    "pending": null,
    "engine": "postgres",
    "version": "18.6",
    "host": "01d4cnjkgq02b6tfqvy8yh391pq.live.nevia.cloud",
    "port": 5432,
    "parent": null,
    "from_checkpoint": "01d4cnjkwhftngfp8vkmp723mhv",
    "generation": 1,
    "protected": false,
    "error": null,
    "created_at": "2026-09-10T12:34:56Z",
    "deleted_at": "2026-09-10T12:34:56Z"
  },
  "connection": {
    "host": "01d4cnjkgq02b6tfqvy8yh391pq.live.nevia.cloud",
    "port": 5432,
    "database": "nevia",
    "user": "nevia_admin",
    "password": "<password>",
    "password_status": "tracked",
    "reset_pending": true,
    "uri": "postgres://nevia_admin:<password>@01d4cnjkgq02b6tfqvy8yh391pq.live.nevia.cloud:5432/nevia?sslmode=require",
    "pooler_uri": "postgres://nevia_admin:<password>@01d4cnjkgq02b6tfqvy8yh391pq.live.nevia.cloud:6432/nevia?sslmode=require",
    "ssl_mode": "require",
    "server_ca": null,
    "pooler_port": 6432
  },
  "operations": [
    "01d4cnjm89yk0r3xtv80dy0x7by"
  ]
}

Authorization

bearerAuth
Authorization Bearer <token>

Send the token in the Authorization: Bearer <token> header. See Authenticate.

In: header

Header Parameters

Idempotency-Key* string

Retry key. A retry with the same key and body replays the first response

Length 1 <= length <= 255

Request Body

application/json

Managed Postgres with fixed size and storage

Behavior

The response carries a database.create operation, finished in a 200 and running in a 202. If connection is null, read it with GET /v1/databases/{db}/connection once the database is ready.

Response

application/json

The database, ready or failed, when the create finished during the request.

Database, its connection and the create operation