List workflows
GET/workflows
Returns a paginated list of all workflows ordered by most recently updated, enriched with run counts, version counts, and simulation counts. Use this to manage the automation library and quickly identify active versus draft workflows.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number (15 workflows per page). Default: |
status | string | No | Filter by workflow status. One of: |
Responses
200 Paginated workflow list with aggregate counts
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · WorkflowDefinitionV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].name | string | No | Human-readable workflow name. Example: |
data[].description | string, nullable | No | Optional explanation of the workflow's purpose. |
data[].trigger | object | No | Trigger configuration. Stored as either a plain string event name or a structured object with an 'event' key and optional filter properties. |
data[].conditions | array of object | No | Array of condition objects that must all evaluate to true before actions are executed. Each condition has a 'field', 'operator', and 'value' key. |
data[].actions | array of object | No | Ordered array of action objects executed sequentially when the workflow fires. Each action has a 'type' and 'config' object. |
data[].throttle_per_minute | integer | No | Maximum executions per minute (0 = unlimited). Example: |
data[].error_policy | string | No | Error handling strategy for failed actions. One of: |
data[].status | string | No | Workflow lifecycle status. One of: |
data[].runs_count | integer | No | Total number of execution runs for this workflow. Example: |
data[].versions_count | integer | No | Number of saved version snapshots. Example: |
data[].created_by | integer, nullable | No | Tenant user ID who created the workflow. |
data[].updated_by | integer, nullable | No | Tenant user ID who last updated the workflow. |
data[].created_at | string (date-time) | No | Record creation timestamp. |
data[].updated_at | string (date-time) | No | Last update timestamp. |
meta | object | No | |
meta.current_page | integer | No | |
meta.per_page | integer | No | |
meta.total | integer | No |
Example
{
"data": [
{
"id": 8,
"name": "New Lead Welcome Email",
"description": "Sends a welcome email when a new CRM lead is created.",
"trigger": "crm.lead.created",
"status": "active",
"throttle_per_minute": 100,
"error_policy": "retry",
"runs_count": 247,
"versions_count": 3,
"simulations_count": 5,
"created_at": "2026-02-10T08:00:00Z",
"updated_at": "2026-03-15T14:22:00Z"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 22
}
}401 Unauthenticated
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/workflows" \
-H "Accept: application/json"