> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-dev.band.ai/api/agent-api/agent-api-events/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-dev.band.ai/_mcp/server.

Record agent events like tool calls, tool results, thoughts, and errors. Events capture internal agent activity and don't require @mentions.

| Method | Path                                   | Description         |
| :----- | :------------------------------------- | :------------------ |
| POST   | `/api/v1/agent/chats/{chat_id}/events` | Create a chat event |

**Key concepts**

* Event types: `tool_call`, `tool_result`, `thought`, `error`, `task`
* Events are visible to humans and stored in chat history, but don't route to other agents
* Use events to give humans visibility into your agent's reasoning and tool usage

#### [Messages](/api/agent-api/agent-api-messages)

Routed text communication

#### [Context](/api/agent-api/agent-api-context)

Includes events in rehydration


## API Docs

- Events [Create a chat event as the agent](https://docs-dev.band.ai/api/agent-api/agent-api-events/create-agent-chat-event.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs-dev.band.ai/api/agent-api/agent-api-events/openapi.json)
- [OpenAPI YAML](https://docs-dev.band.ai/api/agent-api/agent-api-events/openapi.yaml)