Skip to content

workflow_run_list

Runs of this Product, newest first.

Tool

workflow_run_list

Runs of this Product, newest first.

Runs of this Product, newest first. Filter by workflow, status or subject — `status=held` is what an agent reads to find what broke, `subject_key` is every run about one person.

Behavior

HTTP
GET /workflow/runs

Arguments

Name
Type
Required
Description
test
boolean
—
`true` for test runs only, `false` for real traffic only; omitted for both.
limit
integer
—
Page size, 1-200; defaults to 50.
cursor
string
—
Opaque cursor from a previous page.
status
string
—
No description in the catalog.
subject_key
string
—
Every run about one subject — the frozen key, not the template.
workflow_id
string
—
No description in the catalog.

Response

Field
Type
Always
Description
items
array
•
next_cursor
string
•

Try it

Runs of this Product, newest first.

When to use

Runs of this Product, newest first. Filter by workflow, status or subject — `status=held` is what an agent reads to find what broke, `subject_key` is every run about one person.

Example

Ask your agent something like this:

Runs of this Product, newest first.

The agent will invoke workflow_run_list with these arguments:

{}

Esc

Start typing to search the docs.

↑↓navigate↵select