Skip to navigation
API ReferenceHarbors

List Harbor Context Versions

Beta

Lists immutable published versions of a Harbor context document without returning content.

Versions are ordered from newest to oldest. Collection items omit content, and the draft is never included. Pagination tokens continue from the last returned version, so publishing a newer version between requests does not shift or duplicate older results.

Published revision IDs are durable artifact identities intended for future Harbor activity and audit records. Publisher IDs are paired with actor types. System publications have published_by_type: "system" and a null published_by because the system actor has no UUID.

A Harbor profile credential can read versions only when harbor_id identifies its own Harbor.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

harbor_idstringRequiredformat: "uuid"
Unique identifier of the Harbor
context_idstringRequiredformat: "uuid"
Unique identifier of the context document

Headers

X-Polytomic-VersionstringOptional
X-Polytomic-Harbor-SessionstringOptional

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

X-Polytomic-Activity-Request-IDstringOptional

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

Query parameters

limitintegerOptional1-50Defaults to 50
Maximum number of published versions to return. Defaults to 50 and cannot exceed 50.
page_tokenstringOptional
Opaque pagination cursor returned by the previous request

Response

OK
datalist of objects or nullOptional
Context versions on this page
paginationobjectOptional
Pagination details for the next page

Errors

403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error