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 Send the token in the Authorization: Bearer <token> header. See Authenticate.
In: header
Header Parameters
Retry key. A retry with the same key and body replays the first response
1 <= length <= 255Request 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/jsonThe database, ready or failed, when the create finished during the request.
Database, its connection and the create operation