Skip to content

sessions module route (requires sessions:run:read)

GET
/v1/m/sessions/runs/{ref}/activity
curl --request GET \
--url https://example.com/v1/m/sessions/runs/example/activity \
--header 'Authorization: Bearer <token>'

Returns what one Claude Code session’s tool is doing, read from the transcript it keeps: the agents it spawned, its background tasks, the files its edits changed, its task list, the skills and MCP servers it used, and its context; read-only.

ref
required
string

Path parameter ref.

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}