List Run Activity

GET /runs/activity

What every in-flight run is doing right now, for the caller’s scope (D-5329).

Declared above GET /{run_id}, and the order is load-bearing. Starlette matches in declaration order, so with the id route first /runs/activity is parsed as a run id and answers 422 on a path that exists — the same shape GET /alerts/incidents sits in above GET /alerts/{alert_rule_id}.

?status= accepts the whole RunStatus vocabulary and refuses the terminal half with a 422 naming it. Narrowing the parameter’s type to the three in-flight labels would put a second, hand-copied spelling of IN_FLIGHT in the signature; one frozen copy of that set already exists, in the index’s predicate, and two would disagree.

viewer, matching GET /runs: whoever may read the run list may read where those runs are. It is deliberately not under /system, which is floored at admin for the fleet-wide counters D-552 scopes to the caller — this is the tenant’s own runs, and putting it there would have put the screen behind a role the people who watch it do not hold.

Role floor

Requires viewer or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
agent_id	query	string (uuid) | null	optional	—
status	query	queued | running | suspended | succeeded | failed | timed_out | cancelled | null	optional	—
limit	query	integer	optional	Default 50. min 1 max 200
cursor	query	string | null	optional	—
offset	query	integer | null	optional	min 0

Responses

Status	Description	Body
200	Successful Response	Page_RunActivityView_
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X GET https://your-deployment.example.com/runs/activity \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — Page_RunActivityView_

Field	Type		Notes
items	RunActivityView[]	required	—
next_cursor	string | null	optional	—
total	integer | null	optional	—