Sign in
sql databases

List SQL databases

Lists the SQL databases for the authenticated user's organization. Results use page-based pagination (page[number]/page[size]) and can be filtered and sorted.

get/storage/sqldbs

Query parameters

page[number]integer

The page number to load.

page[size]integer

The size of the page. Values above 250 are treated as 250.

filter[name]string

Filter by exact name match.

filter[status]'pending' | 'provision_ok' | 'provision_failed' | 'deleting' | 'delete_failed'

Filter by provisioning status.

sort'name' | '-name' | 'status' | '-status' | 'created_at' | '-created_at'

Sort field; prefix with - for descending order.

Response

SQL databases retrieved successfully

Example response

{
  "data": [
    {
      "record_type": "storage_sqldb",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "my-database",
      "status": "provision_ok",
      "created_at": "2026-06-18T14:48:17Z",
      "updated_at": "2026-06-18T14:48:17Z"
    }
  ],
  "meta": {
    "page_number": 1,
    "page_size": 20,
    "total_pages": 3,
    "total_results": 52
  }
}

Changes

Changed in 2 of the 99 revisions of this API.225

  • a6a61a29ecdd224See the full diff
    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ●

      removed the optional property /// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property /// from the response with the status

      response-optional-property-removed

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    This revision also has 34 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1571b0380bd71See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 99 revisions, 1 has no diff computed.