Skip to main content
POST
Add task status updates (Internal API)

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_execution_id
string<uuid>
required

UUID of the flow execution receiving task status updates. Must be an active (non-deleted) execution.

Body

application/json

Batch request to add multiple task status updates.

Allows system workers to report status changes for multiple tasks in a single API call for improved performance.

statuses
AddTaskStatusRequestItem · object[]
required

Array of task status updates to apply. Minimum: 1 update, Maximum: 100 updates per request. Updates are processed in order provided.

Required array length: 1 - 100 elements
Example:

Response

Task status updates successfully recorded

flow_execution_id
string<uuid>
required
id
string<uuid>
required
organization_id
string<uuid>
required
status
enum<string>
required

Valid status values for task processing lifecycle.

Used by task_execution and task_output tables to track where a task is in its processing pipeline, independent of data consistency state.

Status Transitions: queued → running → completed → failed running/awaiting_input → skipped (task_execution only, e.g. webhook timeout) running/awaiting_input → cancel_requested → cancelled Any status → deleted (soft delete)

Available options:
queued,
running,
completed,
failed,
deleted,
awaiting_input,
cancel_requested,
cancelled,
skipped
task_name
string
required
created_at
string<date-time> | null