API ReferenceAgent API

Create a chat event as the agent

Creates a new event in a chat room. Events do NOT require mentions - they report what happened rather than directing messages at participants. Use this endpoint to record: - **tool_call**: When the agent invokes a tool - **tool_result**: The result returned from a tool execution - **thought**: Agent's internal reasoning or thinking process - **error**: Error messages and failure notifications - **task**: Task-related messages For text messages with mentions, use POST /agent/chats/{chat_id}/messages instead.

Authentication

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

Path parameters

chat_idstringRequiredformat: "uuid"
Chat Room ID

Request

Event parameters
eventobjectRequired
Request to create a chat event. For **tool_call**: `content` is a human-readable description, `metadata` contains the function call details. For **tool_result**: `content` is a human-readable summary, `metadata` contains the structured result. For **thought**: `content` is the agent's reasoning text. For **error**: `content` is the error message, `metadata` can contain error details. For **task**: `content` is the task-related message.

Response

Event created
dataobject
Minimal response after creating an event. Contains only essential fields to confirm recording.

Errors