List Harbor Saved Queries
Changed onLists 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.
Request
- Base URLhttps://app.polytomic.com
- Auth
- HTTP bearer
- or HTTP basic
Path parameters
Unique identifier of the Harbor
Query parameters
Maximum number of saved queries to return
Opaque pagination cursor returned by the previous request
Headers
Harbor session token; when supplied, the session must be active and bound to this credential and Harbor.
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 fromobjectto no type for status - warning
removed the optional property
/from the response with the status - info
added to the
response propertyallOflist for the response status
- breaking
- info
endpoint added
- info