Skip to main content
List recent async routine runs in the workspace, with status and progress counters. 
clay routines runs list [--limit <n>] [--cursor <token>]
Results are paginated. --limit sets the page size, and the response includes a top-level cursor when more runs are available; pass it back with --cursor to fetch the next page.

​
Flags

FlagDescription
--limit <n>Maximum runs to return per page. Must be a positive integer up to 100. Defaults to 20.
--cursor <token>Resume from a previous response’s cursor to fetch the next page.

​
Output

{
  "data": [
    {
      "routineRunId": "run_abc123",
      "routineId": "function:t_abc123",
      "status": "in_progress",
      "total": 100,
      "finished": 42
    }
  ],
  "cursor": "next_page_token"
}
FieldTypeDescription
data[].routineRunIdstringRun id. Pass to clay routines runs get.
data[].routineIdstringThe routine that was run.
data[].status"in_progress" | "complete" | "validation_failed"Current run status.
data[].totalnumberTotal items in the run.
data[].finishednumberItems that have finished so far.
cursorstringPresent when more runs are available. Pass it back via --cursor. Omitted on the last page.

​
Errors

CodeExitNotes
validation_error2--limit is not a positive integer or exceeds 100.
auth_forbidden3The API key lacks the cli:all scope (or all).

​
Examples

clay routines runs list
clay routines runs list --limit 10 | jq -r '.data[].routineRunId'
clay routines runs list --limit 10 --cursor "$CURSOR"
clay routines runs list | jq '.data[] | select(.status == "in_progress")'