v2

latestOpenAPI 3.1.02026-07-2675166192.8 KB
agent_traces

Upload Session

Overwrite the stored JSONL for this session.

Body is raw NDJSON; the CLI sends the entire local session file each call. Content-Length is checked before the body is read so oversized requests are rejected without buffering bytes.

put/api/v1/agent-traces/sessions/{session_id}

Path parameters

session_idstring required

Headers

x-trace-idstring

Root session id in the recursion tree.

Root session id in the recursion tree.

x-parent-sessionstring nullable

Parent session id if this is a sub-agent session.

Parent session id if this is a sub-agent session.

x-cwdstring nullable

Working directory the agent was launched from.

Working directory the agent was launched from.

x-agent-versionstring nullable

prime-agent version string.

prime-agent version string.

Response

Successful Response

session_idstring required
trace_idstring required
bytes_storedinteger required
keystring required

R2 object key the session was written to