agentApiEvents

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.

post/api/v1/agent/chats/{chat_id}/events

Path parameters

chat_idstring uuid required

Chat Room ID

Headers

X-API-Keystring required

Enter your API key for programmatic access

Request body

Response

Event created

EventsCreateAgentChatEventResponse201 required— unresolved $ref

Changes