Sign in

v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2113138232.4 KB
agent_sessions

upload a new agent session

Upload a new agent session.

S3 Upload Workflow:

  1. Call the S3 presign endpoint to obtain a direct upload URL for the raw session transcript file.
  2. Upload the raw transcript to S3.
  3. Send a POST request to this endpoint with the S3 key (s3_key) and the pre-parsed, curated JSON payload (curated_data).
post/api/agent_sessions

Request body

titlestring

Title for the session (auto-generated if omitted)

curated_datastring required

JSON string of curated session data with messages array and metadata.

s3_keystring

S3 object key from presign endpoint (optional).

tool_name'claude_code' | 'codex' | 'gemini_cli' | 'github_copilot' | 'opencode' | 'pi'

Tool that produced the session (e.g. claude_code, codex).

Response

created

idinteger required
slugstring required
titlestring required
tool_namestring required

Tool that produced the session (e.g. claude_code, codex)

total_messagesinteger required
publishedboolean required
created_atstring date-time required
updated_atstring date-time
urlstring url required