List Cycles Api V1 Workstreams Cycles Get

get/api/v1/workstreams/cycles

List cycles (fleet view)

List execution cycles with filtering options. Provides a fleet view of all workflow executions across blueprints. **Query Parameters:** - `workstream_id`: Filter by parent workstream (matches both the denormalised `cycle.workstream_id` column and, for legacy containerized cycles where it may be null, the workstream id reachable via the blueprint join) - `blueprint_id`: Filter by blueprint - `client_id`: Filter by client - `status`: Filter by status - `limit`: Results per page (1-100, default: 20) - `offset`: Pagination offset (default: 0) **Authentication Required:** JWT Bearer token

Query parameters

`workstream_id` query	Filter by parent workstream
`blueprint_id` query	Filter by blueprint
`client_id` query	Filter by client
`status` query	Filter by status
`limit` query	Results per page
`offset` query	Pagination offset

Responses

200Cycles retrieved successfully

Field	Type	Description
`items`	`CycleResponse[]`	— item shape CycleResponse
`pagination`required	`Pagination`	Pagination information show nested Pagination

401Unauthorized

422Validation Error

Field	Type	Description
`detail`	`ValidationError[]`	— item shape ValidationError

curl https://api.dev.arch.ie/api/v1/workstreams/cycles \
  -H "Authorization: Bearer sk_..."