List the instances of a given workflow, optionally filtered.
Filtering can be applied using the following query parameters:
name
: All instances with the name containing this substringordering
: Sorting by ascending or descending options: status, priority, ended_time, total_runtime, started_time. Use -
to sort in a descending manner, for example: -status
status
: Use one of the options: running
, completed
, aborted
progress
: With suffix _min
or _max
active_step_id
: Returns all instances of a workflow for which the step with the specified ID hasn’t been completed and is currently activepriority
: Use one of the options: V
(Very High) or H
(High)started_time
: With suffix _after
or _before
last_updated_time
: With suffix _after
or _before
deadline
: With suffix _after
or _before
step_deadline
: With suffix _after
or _before
aborted_time
: With suffix _after
or _before
completed_time
: With suffix _after
or _before
ended_time
: With suffix _after
or _before
total_runtime_min
: Instance duration as %d %H:%M:%S.%f
or ISO formattotal_runtime_max
: Instance duration as %d %H:%M:%S.%f
or ISO formattags
: Name of the tag or tags separated by comma. Multiple tags are searched as OR condition.page
: For pagination.Dates follow the ISO8601 format and UTC standard.
Page size is 100 by default, 500 maximum. To paginate, follow the standard usage of limit
and page
parameters.
Authentication is API key based. As an admin, you can generate an API key in Next Matter by going to Company > Next Matter API keys.
When sending requests to the API, authenticate by passing the API key in the "Authorization" HTTP header, prepended with the string "Api-Key ".
For example:
Authorization: Api-Key xyzabc.12fsfe242ubdgakew
organization
process
lead_user
progress
Ordering
name
, -name
, started_time
, -started_time
, last_updated_time
, -last_updated_time
, status
, -status
, priority
, -priority
, progress
, -progress
, deadline
, -deadline
, ended_time
, -ended_time
, total_runtime
, -total_runtime
status
running
, completed
, aborted
name
query
priority
V
, H
started_time
last_updated_time
deadline
step_deadline
aborted_time
completed_time
ended_time
total_runtime_min
total_runtime_max
active_step_id
tags
A page number within the paginated result set.
Number of results to return per page.
The response is of type object
.