Activity

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

MethodPathDescription
POST/api/v1/agent/chats/{chat_id}/activityReport 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.