Read one agent's trace
Returns one page of an agent’s steps, oldest first. A step is an agent message, a tool call, a tool result, or a reported finding. Long payloads are shortened and marked with truncated. To read a shortened payload in full, call GET /scans//trace/ with the step’s event_id. To read the next page, send the returned cursor value. If the response contains a note field, the trace is incomplete and the note tells you why.
Authorizations
API token obtained from the Tokens endpoint. Include as Authorization: Bearer <token>.
Path Parameters
Query Parameters
Agent to read, from GET /scans/{scanId}/agents.
Cursor returned by the previous page.
Maximum number of steps to return. The default is 40 and the maximum is 100.
1 <= x <= 100Return only the steps of one tool.
Response
One page of agent steps.
The response is of type object.