Skip to main content
GET
CLI

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string
required

Workspace ID.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

agentId
string
required
Example:

"agent_01HXKD2E5NQM3T9AYWCFMGWT9Y"

Query Parameters

cursor
string

Pagination cursor from previous response

limit
integer<int32>

Maximum number of results to return

objectiveId
string

Optional filter by objective ID

Example:

"obj_01HXKD2E5NQM3T9AYWCFQAZGFV"

eventType
enum<string>

Optional filter by event type

Available options:
OBJECTIVE_EVENT_TYPE_UNSPECIFIED,
OBJECTIVE_EVENT_TYPE_USER_MESSAGE,
OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED,
OBJECTIVE_EVENT_TYPE_TOOL_APPROVED,
OBJECTIVE_EVENT_TYPE_TOOL_DENIED,
OBJECTIVE_EVENT_TYPE_TOOL_CALLED,
OBJECTIVE_EVENT_TYPE_ERROR,
OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE,
OBJECTIVE_EVENT_TYPE_TOOL_RESULT,
OBJECTIVE_EVENT_TYPE_TOOL_ERROR,
OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED,
OBJECTIVE_EVENT_TYPE_MEMORY_READ,
OBJECTIVE_EVENT_TYPE_CANCELLED,
OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED,
OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED,
OBJECTIVE_EVENT_TYPE_FINALIZED,
OBJECTIVE_EVENT_TYPE_NOTICE,
OBJECTIVE_EVENT_TYPE_TIMED_OUT,
OBJECTIVE_EVENT_TYPE_REASONING
labels
string

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

Response

OK

items
object[]
required
pagination
object

Page carries cursor-based pagination state. There is no total: the cursor walks the result set without ever counting it, and a count would cost a second query on every list.