---
title: "Report an agent activity-state signal for a session"
method: POST
path: "/api/v1/sessions/{sessionId}/activity"
tags: ["sessions"]
---

# Report an agent activity-state signal for a session

`POST /api/v1/sessions/{sessionId}/activity`

## Path parameters

- `sessionId` string, required — Session identifier, e.g. project-1.

## Request body

- SetActivityRequest
  - `state` 'active' | 'idle' | 'waiting_input' | 'exited', required — Agent activity state reported by an agent hook.

## Response `200`

OK

- SetActivityResponse
  - `ok` boolean, required
  - `sessionId` string, required
  - `state` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-06-10** `b64f5ab46d87` — 2 breaking, 4 warning
  - the request property `state` became required
  - removed the enum value `blocked` of the request property `state`
  - removed the request property `agentSessionId`
  - removed the request property `event`
  - …2 more

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/:sessionId/activity/post.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/3cbe4004af21?raw)