Databases

Create a database

POST/api/v1/organizations/{organization_id}/projects/{project_id}/databases

Starts provisioning an isolated Postgres instance. Returns immediately with 202 Accepted and a job_id. The database.created webhook fires when it is ready.

Bearer token or API key

Path parameters

organization_idstring (uuid)required
project_idstring (uuid)required

Body

namestringrequired
Database name, unique within the project.
region_codestringrequired
Where to run it, e.g. eu-west.
isolation_levelenumoptional
Isolation level. Allowed: shared, dedicated.
cpu_limitintegeroptional
vCPUs to allocate.
ram_limit_mbintegeroptional
RAM in megabytes.
storage_limit_mbintegeroptional

Responses

202Accepted — provisioning started
[4xx]Plan limit reached — upgrade to create more databases
422Validation error