Send Chat Message

Send a message to an existing AI Agent conversation session.

POST/api/v1/workspaces/{workspace_uuid}/agents/{agent_uuid}/sessions/{session_uuid}/chat

Send a message to an existing AI Agent conversation.

This endpoint sends a chat message to an active session. The Agent uses the conversation history associated with the provided session_uuid to generate context-aware responses.

Before calling this endpoint, you must first create a session using the Create Session endpoint.

*Required field

Headers

Header	Type	Description
`Authorization`*	`string`	Bearer token in the format Bearer <your_api_token>
`Content-Type`*	`string`	Must be set to application/json

Parameters

Parameter	Type	Description
`workspace_uuid`*	`string`	Unique identifier of the workspace.
`agent_uuid`*	`string`	Unique identifier of the AI Agent.
`session_uuid`*	`string`	Conversation session identifier returned by the Create Session endpoint.

Request Body

Field	Type	Description
`message`*	`string`	The message to send to the AI Agent.

Response Status Codes

200Chat message submitted successfully.

400Bad Request. Invalid or missing request body.

401Unauthorized. Invalid or missing API token.

404Session or Agent not found.

curl -X POST \
  https://{your_domain}/api/v1/workspaces/{workspace_uuid}/agents/{agent_uuid}/sessions/{session_uuid}/chat \
  -H "Authorization: Bearer <your_api_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello! How can you help me today?"
  }'

Response 200JSON

{
  "meta": {
    "agent_uuid": "agn-...",
    "message": "Your chat message has been sent successfully",
    "start_at": 1779257420354,
    "status": "SUBMITTED"
  },
  "result": {
    "output": "Hello!, How can I help you today."
  }
}