Send Agent Session Message
Post a human message into a durable (keyed) session's conversation. 409 for react/cron, non-interactive, and closed sessions. Returns the created message so the caller can track it by id; a retried send with the same idempotency_key returns the original message.
Post a human message into a durable (keyed) session's conversation.
409 for react/cron, non-interactive, and closed sessions. Returns the created message so the caller can track it by id; a retried send with the same idempotency_key returns the original message.
Authorization
HTTPBearer In: header
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A human message posted into a durable session's conversation. Delivered to the live agent at the next turn boundary, or wakes the session when idle.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/sessions/string/messages" \ -H "Content-Type: application/json" \ -d '{ "message": "string" }'{ "agent_session_id": "string", "author": "string", "body": "string", "created_at": "2019-08-24T14:15:22Z", "delivered_at": "2019-08-24T14:15:22Z", "delivered_turn_id": "string", "feed_seq": 0, "id": "string", "sender_attribution_id": "string", "sender_attribution_type": "github_user", "status": "pending"}Get Agent Session Log
Return the session log — the complete, ordered, downloadable history of the session (agent output, tool calls, thinking, lifecycle events, sandbox output, message events) as an ordered manifest of presigned segment URLs. Segments are gzip members: download in order and concatenate for one file. The JSON API never carries the bytes (same two-step as assets). /records is the paged live view of the same data.
Get Agent Session Port
Return the preview link for a port in the session's live sandbox (a dev server running there): the same dashboard page as the IDE, deep-linked to the port. Backs `agent session port`.