curl "https://developer.encrata.com/api/workflows?status=active&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "active", "limit": 20, "offset": 0},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows");
url.searchParams.set("status", "active");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"workflows": [
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Enrich new leads",
"description": "Email lookup then webhook",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://hooks.example.com/lead" } }
],
"run_count": 42,
"last_run_at": "2026-05-28T14:31:02Z",
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-28T14:30:00Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
Workflows
List Workflows
List all workflows for the authenticated user.
GET
/
api
/
workflows
curl "https://developer.encrata.com/api/workflows?status=active&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "active", "limit": 20, "offset": 0},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows");
url.searchParams.set("status", "active");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"workflows": [
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Enrich new leads",
"description": "Email lookup then webhook",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://hooks.example.com/lead" } }
],
"run_count": 42,
"last_run_at": "2026-05-28T14:31:02Z",
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-28T14:30:00Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
Overview
Returns the workflows on your account. Use it to find a workflow’sid before
calling Get workflow or
List workflow runs.
Authentication
Requires an API key in theAuthorization header.
Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Request
integer
default:"20"
Number of workflows to return.
integer
default:"0"
Number of workflows to skip. Pagination is offset-based. There is no
page parameter; sending one has no effect.string
Filter by status:
active, paused, draft, or archived. The value is
passed through unvalidated, so an unknown status returns an empty list rather
than an error.Example request
curl "https://developer.encrata.com/api/workflows?status=active&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "active", "limit": 20, "offset": 0},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows");
url.searchParams.set("status", "active");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
limit to offset and repeat until
offset + limit >= total.
Response
object[]
The matching workflows.
Show workflow
Show workflow
string
The workflow’s UUID.
string
The owning user’s UUID.
string
Display name.
string
Human-readable description. Omitted when empty.
string
active, paused, draft, or archived.object
Trigger configuration.
type is one of manual, webhook, schedule,
file_upload, or monitor_event.object[]
The step definitions, in order.
object[]
Connections between steps. Omitted when the workflow is linear.
string
The template this workflow was created from. Omitted when none.
integer
Total number of runs.
string
ISO 8601 timestamp of the most recent run. Omitted when never run.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-update timestamp.
integer
Total number of workflows matching the filter, ignoring
limit and offset.integer
The
limit that was applied.integer
The
offset that was applied.Errors
| Status | Cause |
|---|---|
401 | Missing or invalid API key |
429 | Rate limit exceeded. See Rate limits |
500 | Unexpected server failure |
curl "https://developer.encrata.com/api/workflows?status=active&limit=20&offset=0" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
resp = requests.get(
"https://developer.encrata.com/api/workflows",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "active", "limit": 20, "offset": 0},
)
print(resp.json())
const url = new URL("https://developer.encrata.com/api/workflows");
url.searchParams.set("status", "active");
url.searchParams.set("limit", "20");
url.searchParams.set("offset", "0");
const resp = await fetch(url, {
headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" },
});
const data = await resp.json();
{
"workflows": [
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Enrich new leads",
"description": "Email lookup then webhook",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://hooks.example.com/lead" } }
],
"run_count": 42,
"last_run_at": "2026-05-28T14:31:02Z",
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-28T14:30:00Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
Next steps
- Get workflow: Read one workflow’s full definition.
- List workflow runs: See execution history.
Was this page helpful?