KHkhotan
Databases

Create a database

Provisions a production Postgres database synchronously and responds 201 with the persisted record whether provisioning ends ready or failed; branch on the returned status. This operation is not idempotent: retrying a request that already succeeded provisions a second database. Omit regionId to use the default region.

post/api/v1/databases

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/databases
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Request body

namestring required
regionIdstring nullable
idempotencyKeystring

Response

The persisted database record, in ready or failed status.

idstring required
displayNamestring required
status'creating' | 'ready' | 'failed' required
providerstring required
regionIdstring required
environment'production' required
postgresVersioninteger required
providerDatabaseNamestring nullable required
providerRoleNamestring nullable required
endpointHoststring nullable required
protectedboolean required
tagsstring[] required
createdAtstring required
updatedAtstring required
readyAtstring nullable required
failedAtstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.