List Harbor Saved Queries

Beta
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.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

harbor_idstringRequiredformat: "uuid"
Unique identifier of the Harbor.

Headers

X-Polytomic-VersionstringOptional
X-Polytomic-Harbor-SessionstringOptional
X-Polytomic-Activity-Request-IDstringOptional

Query parameters

limitintegerOptional1-50Defaults to 50
Maximum number of saved queries to return.
page_tokenstringOptional
Opaque pagination cursor returned by the previous request.

Response

OK
datalist of objects or nullOptional
paginationobjectOptional

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error
503
Service Unavailable Error