Postgres

List of Postgres service backups

This endpoint is in beta. API contract is stable, and no breaking changes are expected in the future. <br /><br /> Returns a list of the base backups retained for a Postgres service, ordered by last modified date, newest first. Results are capped at limit (default and maximum 100) per page. Every response carries limit, totalCount and nextCursor; pass nextCursor as the cursor query parameter to fetch the next page, repeating until it is null. A Postgres service is recovered to a point in time rather than to a single backup, so restore it with the restore endpoint and a timestamp rather than with a backup key from this list.

get/v1/organizations/{organizationId}/postgres/{postgresId}/backups

Request

  • Base URL: https://api.clickhouse.cloud
  • URL: https://api.clickhouse.cloud/v1/organizations/{organizationId}/postgres/{postgresId}/backups
  • Auth: HTTP basic

Path parameters

organizationIdstring uuid required

ID of the organization that owns the Postgres service.

postgresIdstring uuid required

ID of the Postgres service the backups were created from.

Query parameters

limitinteger

Maximum number of results to return.

cursorstring

Opaque cursor from a previous response's nextCursor, marking where to resume the list.

Response

Successful response

statusnumber

HTTP status code.

requestIdstring uuid

Unique id assigned to every request. UUIDv4

limitinteger

Maximum number of results returned in this page.

totalCountinteger nullable

Total number of results across all pages. It has only informative value, thus is not guaranteed and it is provided on a best-effort basis. Null if the total count is unknown.

nextCursorstring nullable

Cursor for the next page, to be sent as the cursor query parameter. Null on the last page.

Example response

{
  "status": 200,
  "result": [
    {
      "key": "basebackups_005/000000010000000000000002_backup_stop_sentinel.json",
      "lastModified": "2026-03-31T18:17:37Z"
    }
  ]
}

Changes

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