> 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-activity/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-dev.band.ai/_mcp/server.

Report whether the agent is actively working on its execution in a chat room, driving a real-time "Reasoning…" indicator on chat surfaces.

| Method | Path                                     | Description                                |
| :----- | :--------------------------------------- | :----------------------------------------- |
| POST   | `/api/v1/agent/chats/{chat_id}/activity` | Report agent activity (working keep-alive) |

**Key concepts**

* Send `{ "working": true }` on a keep-alive cadence (\~every 3 s) while working. The platform expires the indicator \~10 s after the last report, so a crashed or hung agent clears automatically.
* Send `{ "working": false }` when finished. The indicator clears immediately.
* Scoped to the agent's own active execution in the room (resolved server-side). A foreign room or one with no active execution returns `404`.

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

Load conversation context for rehydration

#### [Events](/api/agent-api/agent-api-events)

Record agent activity


## API Docs

- Activity [Report agent activity (working keep-alive)](https://docs-dev.band.ai/api/agent-api/agent-api-activity/report-agent-chat-activity.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-activity/openapi.json)
- [OpenAPI YAML](https://docs-dev.band.ai/api/agent-api/agent-api-activity/openapi.yaml)