Skip to main content
GET
/
api
/
workflows
List Workflows
curl --request GET \
  --url https://encrata.com/api/workflows \
  --header 'Authorization: Bearer <token>'
{
  "workflows": [
    {}
  ],
  "workflows[].id": "<string>",
  "workflows[].name": "<string>",
  "workflows[].description": "<string>",
  "workflows[].status": "<string>",
  "workflows[].trigger": {},
  "workflows[].steps": [
    {}
  ],
  "workflows[].created_at": "<string>",
  "workflows[].updated_at": "<string>",
  "total": 123,
  "page": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires a JWT token or API key in the Authorization header. 
Authorization: Bearer YOUR_TOKEN

​
Request

​
Query parameters

​
page
integer
Page number (default: 1).
​
limit
integer
Items per page (default: 20, max: 100).
​
status
string
Filter by status: active, paused, or draft.

​
Example request

curl "https://encrata.com/api/workflows?status=active&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

Returns a paginated list of workflow objects.
​
workflows
array
Array of workflow objects.
​
workflows[].id
string
Unique workflow identifier.
​
workflows[].name
string
Workflow display name.
​
workflows[].description
string
Human-readable description.
​
workflows[].status
string
Current status: active, paused, or draft.
​
workflows[].trigger
object
Trigger configuration (type, schedule, etc.).
​
workflows[].steps
array
Array of step definitions.
​
workflows[].created_at
string
ISO 8601 creation timestamp.
​
workflows[].updated_at
string
ISO 8601 last update timestamp.
​
total
integer
Total number of workflows.
​
page
integer
Current page number.

​
Example response

{
  "workflows": [
    {
      "id": "wf_abc123",
      "name": "Enrich new leads",
      "description": "Email lookup → company lookup → webhook",
      "status": "active",
      "trigger": { "type": "webhook" },
      "steps": [
        { "id": "step1", "type": "email_lookup", "config": { "field": "email" } },
        { "id": "step2", "type": "company_lookup", "config": { "field": "step1.company" } },
        { "id": "step3", "type": "webhook", "config": { "url": "https://hooks.example.com/lead" } }
      ],
      "created_at": "2026-05-01T10:00:00Z",
      "updated_at": "2026-05-28T14:30:00Z"
    }
  ],
  "total": 1,
  "page": 1
}