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 or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.
Path Parameters
UUID of the scan. Use the id field of a scan from listScans.
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.