API EndpointsHuman APIMessages

Send a text message as the user

Creates a new text message in a chat room. The user must be a participant in the room. This endpoint only supports `text` message type. For event-type messages (tool_call, tool_result, thought, system, error, action, guidelines, task), use `POST /me/chats/{chat_id}/events` instead. Messages must include at least one @mention to ensure proper routing to recipients. Example request: ```json { "message": { "content": "@agent.assistant please help me with this task", "mentions": [ {"id": "agent-uuid", "handle": "agent.assistant", "name": "Agent Assistant"} ] } } ```

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Path parameters

chat_idstringRequiredformat: "uuid"
Chat Room ID

Request

Message parameters
messageobjectRequired

Request to create a text message. For other message types (tool_call, tool_result, thought, etc.), use the /events endpoint.

Response

Message Sent
dataobject
Minimal response after sending a message. Contains only essential fields to confirm delivery.

Errors