Antimatter

GET/api/traces/{traceId}Signed in session

Scoped to the owning account at the query. Captured bodies are the caller's own prompts: they are never public, never exported to another account, and they disappear once the key's retention window passes.

Parameters

Path and query parameters
Field	Type	What it is
traceId (path)required	string	32 hex characters.

Answer 200

The spans, and the capture when there is one.

Fields of the 200 answer
Field	Type	What it is
spans	array of TraceSpan
spans[].spanId	string
spans[].parentSpanId	string or null
spans[].name	string
spans[].kind	string	One of "request", "attempt".
spans[].model	string or null
spans[].upstream	string or null
spans[].attempt	integer
spans[].retry	boolean	True when this attempt repeated the previous model and upstream.
spans[].startedAt	integer
spans[].endedAt	integer
spans[].durationMs	integer
spans[].ttftMs	integer or null
spans[].promptTokens	integer
spans[].completionTokens	integer
spans[].costMicros	integer
spans[].status	integer or null
spans[].error	string or null
capture	RequestCapture	The stored request and response. Visible only to the account that made the call, never public, and deleted once expiresAt passes.
capture.traceId	string
capture.ts	integer
capture.expiresAt	integer	When this body is deleted.
capture.model	string
capture.upstream	string
capture.status	integer
capture.stream	boolean
capture.costMicros	integer
capture.ttftMs	integer or null
capture.totalMs	integer or null
capture.promptTokens	integer
capture.completionTokens	integer
capture.requestBody	string or null	Untrusted text. Render escaped.
capture.requestBytes	integer	The original size, even when truncated.
capture.requestTruncated	boolean	True when the text above is a prefix.
capture.responseBody	string or null	Untrusted text. Render escaped.
capture.responseBytes	integer
capture.responseTruncated	boolean
capture.replayOf	string or null

Errors

400OpenAI shaped error.
401OpenAI shaped error.
404OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.