Sign in

v1

latestOpenAPI 3.0.32026-07-17485661.9 KB

List databases

Lists all databases in a space.

get/spaces/{space_id}/databases

Path parameters

space_idstring required

Ghost space ID.

Response

List of databases

idstring required

Database ID.

namestring required

Database name. Unique within the space.

type'standard' | 'dedicated' required

Database deployment model.

  • standard — shared-resource databases subject to the space's compute and storage limits.
  • dedicated — per-instance paid databases with guaranteed resources, exempt from space-level auto-pause.
size'1x' | '2x' | '4x' | '8x'

Compute size for dedicated databases. Each step up allocates proportionally more vCPU and RAM.

status'queued' | 'configuring' | 'running' | 'pausing' | 'paused' | 'resuming' | 'deleting' | 'deleted' | 'upgrading' | 'unstable' | 'unknown' required

Current lifecycle status of the database.

hoststring required

PostgreSQL hostname for connections.

portinteger required

PostgreSQL port for connections.

passwordstring nullable

PostgreSQL password for the default user. Returned on every GET for authorized callers.

storage_mibinteger nullable

Current disk usage in MiB. Null if not yet available.

compute_minutesinteger nullable

Compute minutes used by this database during the current billing cycle. Only populated for standard databases.