FOforem
agent_sessions

upload a new agent session

Changed on

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 with a PUT to presigned_url, sending exactly the returned headers.
  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

  • Base URL
    https://dev.to
  • Auth
    • API key in header api-key
    • or HTTP bearer

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'antigravity_cli' | '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

Changes

  • v1dace1b9a8248Revision changes
    • info

      added the new antigravity_cli enum value to the request property

  • v17db6ba099285Revision changes
    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status