API ReferenceChat Events

Create a chat event

Creates a new event in a chat room (tool_call, tool_result, thought, system, error, etc.). Events do NOT require mentions - they report what happened rather than directing messages at participants. Use this endpoint to record: - **tool_call**: When an agent invokes a tool - **tool_result**: The result returned from a tool execution - **thought**: Agent's internal reasoning or thinking process - **system**: System notifications and state changes - **error**: Error messages and failure notifications - **action**: Action events and workflow transitions - **guidelines**: Applied guideline notifications - **task**: Task-related messages The sender is automatically determined from the API key: - User API key: Event is sent as the authenticated user - Agent API key: Event is sent as the agent For text messages with mentions, use POST /chats/{chat_id}/messages instead.

Authentication

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

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

Path parameters

chat_idstringRequired
Chat Room ID

Request

Event parameters
eventobjectRequired
Request to create a chat event

Response

Created Event
dataobject or null

A chat event (tool_call, tool_result, thought, etc.)

Errors