Documentation menu
System Agent Events

List retained discoverable System Agent events

GET /api/v1/agents/{coordinator}/events

Parameters

path

NameTypeRequiredDescription
coordinatorstringrequiredIdentifies the coordinator agent by its canonical name. Applies to List retained discoverable System Agent events.

query

NameTypeRequiredDescription
organizationIdstringoptionalSelects the organization for the System Agent event consumer. Required for sessions. Organization-scoped credentials may omit it.
cursorstringoptionalOpaque cursor returned by the previous page; omit it to read the first page. Applies to List retained discoverable System Agent events.
cursorVersion"1" | "2"optionalEvent cursor protocol version. Without a cursor, default 1 preserves legacy behavior. Opt in to 2 on rebaseline; list requests infer the signed cursor version when the selector is omitted. An explicit selector must match the cursor. On retryable 409 conflict with concurrent_commit, retry the same request with the same cursor, if supplied. On 409 rebaseline_required, fetch a fresh baseline. Applies to List retained discoverable System Agent events.
limitintegeroptionalSets the maximum number of resources returned in this page. Applies to List retained discoverable System Agent events.

Responses

StatusDescriptionBody
200Response for status 200application/json — object — cursorVersion: 2; readPosition: object; events: array<object> (required); pagination: object (required)
400The request is malformed or cannot be processed.application/json — PublicApiError — error: object (required)
401Authentication failed. The Authorization header is missing, or the credential is invalid or expired.application/json — PublicApiError — error: object (required)
403Access denied. The authenticated user does not have permission to perform this action.application/json — PublicApiError — error: object (required)
404Resource not found.application/json — PublicApiError — error: object (required)
409Request conflicts with current state of the resource, including safe deployment conflict classifications.application/json — PublicApiError — error: object (required)
422Request validation failed. Check the request body, query parameters, or path parameters.application/json — PublicApiError — error: object (required)
429Too many requests.application/json — PublicApiError — error: object (required)
500The server could not complete the request.application/json — PublicApiError — error: object (required)
503Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff.application/json — PublicApiError — error: object (required)