List Workflows

List all workflows for the authenticated user.

GET /api/workflows

List Workflows

cURL

curl --request GET \
  --url https://encrata.com/api/workflows \
  --header 'Authorization: Bearer <token>'

200

{
  "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
}

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
}