Agents

Post Agent Session Message

Append a message to an agent session WITHOUT asking for a reply.

No model runs and nothing is charged: the message is stored in the session's log and shown to anyone watching it. Use POST /agent/chat to get an answer. A session you cannot see is a 404.

post/agent/sessions/{session_id}/messages

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/sessions/{session_id}/messages
  • Auth: HTTP bearer

Path parameters

session_idstring required

Session id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

contentstring required

The message text.

Response

Successful Response

dataAgentConversationPayload required

An open envelope for the app's answer.

Open because the chat answer (kind, message, chips, sources, work_item_id, ...) and the oversight feed (approvals, blockers, autonomous_fixes, states, bounds) are both still growing, and a dropped field on an agent surface is one the caller does not know they lost.

Changes

No recorded changes to this operation across all 2 revisions of this API.