List Workflows
Workflows
List Workflows
Retrieve a paginated list of your workflows
GET
List Workflows
Overview
Retrieve all workflows created by your account with pagination support. Results are ordered by creation date (newest first).Query Parameters
integer
Page number to retrieve (default: 1, minimum: 1).
integer
Number of workflows per page (default: 10, minimum: 1, maximum: 100).
string
Filter workflows by status (possible values: “completed”, “running”, “queued”, “failed”, “cancelled”)
Response
array
required
Array of workflow objects.
integer
required
Total number of workflows across all pages.
Workflow Object
string
required
Unique identifier (UUID) for the workflow.
string
required
The workflow’s name.
string
required
Current status of the workflow.Possible values:
accepted, uploaded, queued, running, completed, cancelled, invalid, failedstring[]
required
Array of tags associated with the workflow.
string
required
ISO 8601 timestamp when the workflow was created.
string
required
ISO 8601 timestamp when the workflow was last updated.
string
ISO 8601 timestamp when execution started (null if not yet started).
string
ISO 8601 timestamp when execution completed (null if not yet completed).
Example Response
Error Responses
error
Unauthorized - invalid or missing authentication token.
Notes
- Results are ordered by creation date (newest first)
- The
totalfield indicates the total count across all pages - All workflow statuses are included in the list
- Use the workflow ID to fetch detailed information or subscribe to updates