Skip to main content
List workflow runs

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Query Parameters

limit
integer
default:50

Maximum number of results per page.

Required range: 1 <= x <= 100
cursor
string

Opaque next_cursor from the previous page. Keep the same filters and sort; omit for the first page.

Maximum string length: 4096
status
string

Comma-separated statuses. Omit to include all statuses, including terminal runs.

Maximum string length: 4000
type
string

Comma-separated public workflow types.

Maximum string length: 4000
created_from
string<date-time>

Inclusive creation time, as a UTC timestamp with at most six fractional digits.

Maximum string length: 27
created_before
string<date-time>

Exclusive creation time, as a UTC timestamp with at most six fractional digits.

Maximum string length: 27
resource_type
enum<string>
Available options:
invoice_import,
workflow_run,
invoice,
agreement,
document,
integration,
agreement_price_import
resource_id
string<uuid>

Owner ID; requires resource_type.

ids
string

Optional comma-separated run IDs, at most 100. Unknown or inaccessible IDs are omitted.

Maximum string length: 4000

Response

A page of visible runs. next_cursor is null at the end.

data
object[]
required
Maximum array length: 100
next_cursor
string | null
required