Chat
Send Message
Send a message to an agent and receive a response.
POST
Request Body
Target agent ID (ag_*)
User message text
Session ID for conversation memory. Reuse to continue a conversation
Enable streaming response (use Stream endpoint instead)
Additional context passed to the agent (e.g., user info, page URL)
Response 200
Response Fields
Agent’s text response
Session ID — reuse for follow-up messages
Tokens consumed by the prompt
Tokens in the agent’s response
Total tokens consumed (billed)
Tools the agent invoked during this response
Example with Metadata
Errors
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Body
application/json
Response
Successful Response

