Harbors

List Harbor Saved Queries

Changed on

Lists current published saved queries for a Harbor.

Saved queries are supported only for Polytomic-managed Harbors whose backing Connection type is polytomic_harbor.

Collection items contain current published metadata and omit SQL, parameter values, and unpublished drafts. A Harbor profile credential can list saved queries only when harbor_id identifies its own Harbor.

Harbor Activity

When you use a Harbor profile credential, send a new nonzero UUID in X-Polytomic-Activity-Request-ID for each request, including each page. A missing or invalid ID returns 400 Bad Request. Reusing a consumed ID returns 409 Conflict.

If you supply X-Polytomic-Harbor-Session, the session must be active and bound to your credential and Harbor. An invalid session returns 403 Forbidden. Direct scoped REST requests may omit the session header.

Polytomic records saved_query.listed before returning data. The event describes only the returned page, including saved-query IDs, immutable revision IDs, version numbers, and bounded name snapshots. Activity excludes SQL, parameter values, and expected column names. If Polytomic cannot record the event, the request returns 503 Service Unavailable without saved-query data.

get/api/harbors/{harbor_id}/saved-queries

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

harbor_idstring uuid required

Unique identifier of the Harbor

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Query parameters

limitinteger

Maximum number of saved queries to return

page_tokenstring

Opaque pagination cursor returned by the previous request

Headers

X-Polytomic-Versionstring
X-Polytomic-Harbor-Sessionstring

Harbor session token; when supplied, the session must be active and bound to this credential and Harbor.

X-Polytomic-Activity-Request-IDstring

New nonzero UUID for each request, required for scoped credentials; a reused value is rejected.

Response

OK

Example response

{
  "data": [
    {
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
    }
  ],
  "pagination": {
    "next_page_token": "AmkYh8v0jR5B3kls2Qcc9y8MjrPmvR4CvaK7H0F4rEwqvg76K=="
  }
}

Changes

    • breaking

      the response's property type changed from object to no type for status

    • warning

      removed the optional property / from the response with the status

    • info

      added to the response property allOf list for the response status

    • info

      endpoint added