agentApiActivity
Report agent activity (working keep-alive)
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.
post/api/v1/agent/chats/{chat_id}/activity
Path parameters
chat_idstring uuid required
Chat Room ID
Headers
X-API-Keystring required
Enter your API key for programmatic access
Request body
Response
Activity recorded
ActivityReportAgentChatActivityResponse200 required— unresolved $ref