Activity

List Harbor Activity

Changed on

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.

get/api/organization/harbor-activity

Request

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

Query parameters

start_timestring date-time required

Inclusive start of the event recorded-time range

end_timestring date-time required

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

limitinteger

Maximum number of events to return. Defaults to 50 and cannot exceed 100.

page_tokenstring

Opaque pagination cursor returned by the previous request. It expires 24 hours after the first page.

order'asc' | 'desc'

Order in which events were recorded. Defaults to desc.

harbor_idstring[]

Return events for these Harbors. Repeat the parameter to filter by multiple IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]
event_typeHarboractivityEventType[]

Return events with these event types. Repeat the parameter to filter by multiple types.

outcomeHarboractivityOutcome[]

Return events with these outcomes. Repeat the parameter to filter by multiple outcomes.

operation_idstring[]

Return events for these operation IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]
session_idstring[]

Return events for these session IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]
actor_idstring[]

Return events for these actor IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]
credential_idstring[]

Return events for these credential IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]
connection_idstring[]

Return events for these Connection IDs.

[
  "248df4b7-aa70-47b8-a036-33ac447e668d"
]

Headers

X-Polytomic-Versionstring

Response

OK

Example response

{
  "data": [
    {
      "actor": {
        "id": "248df4b7-aa70-47b8-a036-33ac447e668d"
      },
      "attempt_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "connection_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "context_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "context_revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "credential": {
        "id": "248df4b7-aa70-47b8-a036-33ac447e668d"
      },
      "harbor_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "metadata": {
        "action_request_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
        "saved_query_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
        "saved_query_revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
      },
      "operation_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "profile": {
        "id": "248df4b7-aa70-47b8-a036-33ac447e668d"
      },
      "query_source": {
        "saved_query": {
          "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
          "revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
        },
        "submission_event_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
      },
      "session_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "targets": [
        {
          "revision_id": "248df4b7-aa70-47b8-a036-33ac447e668d"
        }
      ]
    }
  ],
  "pagination": {
    "next_page_token": "AmkYh8v0jR5B3kls2Qcc9y8MjrPmvR4CvaK7H0F4rEwqvg76K=="
  }
}

Changes

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • info

      added the enum value access.denied to the property items/ of the query request parameter event_type

    • info

      added the enum value action.attempt_started to the property items/ of the query request parameter event_type

    • info

      added the enum value action.configuration_changed to the property items/ of the query request parameter event_type

    • info

      added the enum value action.failed to the property items/ of the query request parameter event_type

    • info

      added the enum value action.listed to the property items/ of the query request parameter event_type

    • info

      added the enum value action.looked_up to the property items/ of the query request parameter event_type

    • info

      added the enum value action.preparation_expired to the property items/ of the query request parameter event_type

    • info

      added the enum value action.prepared to the property items/ of the query request parameter event_type

    • info

      added the enum value action.succeeded to the property items/ of the query request parameter event_type

    • info

      added the enum value action.unknown to the property items/ of the query request parameter event_type

    • info

      added the enum value connection.listed to the property items/ of the query request parameter event_type

    • info

      added the enum value context.fetched to the property items/ of the query request parameter event_type

    • info

      added the enum value context.listed to the property items/ of the query request parameter event_type

    • info

      added the enum value denied to the property items/ of the query request parameter outcome

    • info

      added the enum value evidence_capability.fetched to the property items/ of the query request parameter event_type

    • info

      added the enum value evidence_link.created to the property items/ of the query request parameter event_type

    • info

      added the enum value failed to the property items/ of the query request parameter outcome

    • info

      added the enum value query.failed to the property items/ of the query request parameter event_type

    • info

      added the enum value query.started to the property items/ of the query request parameter event_type

    • info

      added the enum value query.submitted to the property items/ of the query request parameter event_type

    • info

      added the enum value query.succeeded to the property items/ of the query request parameter event_type

    • info

      added the enum value saved_query.fetched to the property items/ of the query request parameter event_type

    • info

      added the enum value saved_query.listed to the property items/ of the query request parameter event_type

    • info

      added the enum value schema.fetched to the property items/ of the query request parameter event_type

    • info

      added the enum value schema.listed to the property items/ of the query request parameter event_type

    • info

      added the enum value session.closed to the property items/ of the query request parameter event_type

    • info

      added the enum value session.expired to the property items/ of the query request parameter event_type

    • info

      added the enum value session.started to the property items/ of the query request parameter event_type

    • info

      added the enum value succeeded to the property items/ of the query request parameter outcome

    • info

      added the enum value unknown to the property items/ of the query request parameter outcome

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • 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

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the 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

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the response property allOf list for the response status