Get trace tree
GET/v1/projects/:project_id/traces/:trace_id/tree
Returns the full execution tree rooted at the given trace (or its root if the given trace is a child). Each node represents one agent's execution session. The children array contains traces triggered by sub-agent tool calls from that trace. A node's generations are listed by GET /v1/projects/{project_id}/generations?trace_id=, and a node's direct children page by GET /v1/projects/{project_id}/traces?parent_trace_id=.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
Trace tree rooted at the resolved root trace
The request was malformed or failed validation.
Unauthorized
Forbidden
Trace not found
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded