List Harbor Activity

Lists Harbor Activity recorded for the caller's organization. You must be an active Organization administrator to use this endpoint. `start_time` is inclusive and `end_time` is exclusive. Both filter the time at which Polytomic recorded each event, which can differ from `occurred_at`. A single request can cover at most 90 days. Results are ordered from newest to oldest by default. Set `order` to `asc` to retrieve the oldest events first. A page contains at most 100 events. Pass `next_page_token` from the response as `page_token` with the same time range, filters, order, and limit to retrieve the next page. The token expires 24 hours after the first page. Pagination uses a live descending cursor, so an event from a transaction that commits between pages can require a fresh traversal. Responses include stable identities, bounded resource snapshots, schema label snapshots with truncation state, field counts, and row counts when available. They do not include internal recorded-order values, submitted SQL, raw field names, detailed provider errors, result rows, or raw pagination tokens. > ℹ️ Activity retention > > Polytomic retains Activity events for at least 90 days. Pagination tokens > expire 24 hours after the first page.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Headers

X-Polytomic-VersionstringOptional

Query parameters

start_timedatetimeRequired

Inclusive start of the event recorded-time range.

end_timedatetimeRequired

Exclusive end of the event recorded-time range. The range can span at most 90 days.

limitintegerOptional1-100Defaults to 50
Maximum number of events to return. Defaults to 50 and cannot exceed 100.
page_tokenstringOptional
Opaque pagination cursor returned by the previous request. It expires 24 hours after the first page.
orderenumOptionalDefaults to desc
Order in which events were recorded. Defaults to desc.
Allowed values:
harbor_idlist of stringsOptional
Return events for these Harbors. Repeat the parameter to filter by multiple IDs.
event_typelist of stringsOptional
Return events with these event types. Repeat the parameter to filter by multiple types.
outcomelist of stringsOptional
Return events with these outcomes. Repeat the parameter to filter by multiple outcomes.
operation_idlist of stringsOptional
Return events for these operation IDs.
session_idlist of stringsOptional
Return events for these session IDs.
actor_idlist of stringsOptional
Return events for these actor IDs.
credential_idlist of stringsOptional
Return events for these credential IDs.
connection_idlist of stringsOptional
Return events for these Connection IDs.

Response

OK
datalist of objects or nullOptional
paginationobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
410
Gone Error
422
Unprocessable Entity Error