Skip to main content
GET
List task summaries for flow version

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Include your access token in the Authorization header as: Bearer YOUR_ACCESS_TOKEN

Example:

Path Parameters

flow_id
string<uuid>
required
version
integer
required

Response

List of task summaries successfully retrieved

created_at
string<date-time>
required
edited_status
enum<string>
required

Whether this task output was manually edited. Values: 'not_edited', 'edited'

Available options:
not_edited,
edited
Example:

"not_edited"

flow_execution_id
string<uuid>
required

UUID of the parent flow execution containing this task

Example:

"550e8400-e29b-41d4-a716-446655440000"

id
string<uuid>
required
modified_by
string
required
processing_status
enum<string>
required

Processing lifecycle status of the task. Common values: 'running', 'completed', 'failed'

Available options:
queued,
running,
completed,
failed,
deleted,
awaiting_input,
cancel_requested,
cancelled,
skipped
Example:

"completed"

stale_status
enum<string>
required

Whether this task output is outdated. Values: 'consistent', 'stale'

Available options:
consistent,
stale
Example:

"consistent"

summary
any
required

Task execution summary data. Structure varies by task type. May contain results, metrics, or status information.

Example:
task_name
string
required

Name of the task as defined in the flow definition. Case-sensitive.

Required string length: 1 - 255
Example:

"process_document"

updated_at
string<date-time>
required
flow_version
integer | null

Version of the flow definition when this task executed. May differ from current flow version if flow was updated.

Required range: x >= 1
Example:

3

tags
string[] | null

Optional list of tags associated with this task. Tags use key:value format for categorization. Example: ['priority:high', 'department:finance']

Example:

"priority:high"