List Team Runs

Team storage and identity

Use the database-backed example Team server. Keep the Team run's returned run_id and session_id; a nested member run is not interchangeable with the Team run. Stored run, checkpoint and session operations require the configured database.

JWT user isolation is opt-in; non-admin service-account PAT callers always self-scope. Scoped callers need their own matching Team session and run, while configured resource authorization also applies. Run and checkpoint lookups return 404 for inaccessible or mismatched records. For factories, retain any factory_input needed by endpoints that reconstruct the Team.

The response is a bare array of Team run projections, without pagination metadata. These projections use run_input and ISO 8601 created_at; the raw single-run polling response uses a different representation.

Pass session_id and optionally an exact uppercase status: PENDING, RUNNING, COMPLETED, ERROR, PAUSED, CANCELLED or REGENERATED. Lowercase or unknown strings currently match nothing and return an empty array. Remote Team run listing is unsupported (400).

GET/teams/{team_id}/runs

List runs for a team within a session, optionally filtered by status.

Useful for monitoring background runs and viewing run history.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

team_id*Team Id

Query Parameters

session_id*Session Id

Session ID to list runs for

status?|

Filter by run status (PENDING, RUNNING, COMPLETED, ERROR)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/teams/string/runs?session_id=string'
null