---
title: "Report agent activity (working keep-alive)"
method: POST
path: "/api/v1/agent/chats/{chat_id}/activity"
tags: ["agentApiActivity"]
---

# Report agent activity (working keep-alive)

`POST /api/v1/agent/chats/{chat_id}/activity`

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

- `{ "working": true }` — the agent is working. Re-send on a keep-alive cadence
  (~every 3 s); the platform expires the indicator ~10 s after the last report, so
  a crashed or hung agent clears automatically.
- `{ "working": false }` — the agent 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.

## Path parameters

- `chat_id` string, uuid, required

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `working` boolean, required — Whether the agent is currently working.

## Response `200`

Activity recorded

- ActivityReportAgentChatActivityResponse200 — unresolved $ref

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - Agent authentication required
- `404` — Not Found - no active execution for this agent in the room
- `422` — Unprocessable Entity
- `503` — Service Unavailable - transient platform fault; retry

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/3cff423845a2/schema)