curl "https://developer.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/{workflow_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const workflowId = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/${workflowId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Lead enrichment pipeline",
"description": "Enrich emails then send to CRM",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://crm.example.com/api/leads" } }
],
"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"
}
Workflows
Get Workflow
Get a single workflow by ID with full definition.
GET
/
api
/
workflows
/
{id}
curl "https://developer.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/{workflow_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const workflowId = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/${workflowId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Lead enrichment pipeline",
"description": "Enrich emails then send to CRM",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://crm.example.com/api/leads" } }
],
"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"
}
Overview
Returns one workflow’s full definition: trigger, steps, edges, and run metadata. Get theid from
List workflows.
Authentication
Requires an API key in theAuthorization header.
Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Request
string
required
The workflow’s UUID. The route matches a UUID only - a non-UUID id returns
404.Example request
curl "https://developer.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/{workflow_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const workflowId = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/${workflowId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
Response
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. Step
config uses {{trigger.<field>}} and
{{steps.<n>.result.<path>}} templating.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.
There is no
version field on the workflow object. Version history is
dashboard-only.Errors
| Status | Cause |
|---|---|
401 | Missing or invalid API key |
404 | No such workflow, the id is not a UUID, or the workflow is archived |
429 | Rate limit exceeded. See Rate limits |
500 | Unexpected server failure |
curl "https://developer.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.get(
f"https://developer.encrata.com/api/workflows/{workflow_id}",
headers={"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(resp.json())
const workflowId = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77";
const resp = await fetch(
`https://developer.encrata.com/api/workflows/${workflowId}`,
{ headers: { Authorization: "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } },
);
const data = await resp.json();
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Lead enrichment pipeline",
"description": "Enrich emails then send to CRM",
"status": "active",
"trigger": { "type": "webhook" },
"steps": [
{ "id": "step1", "type": "email_lookup", "config": { "mode": "identity", "input": "{{trigger.email}}" } },
{ "id": "step2", "type": "webhook", "config": { "url": "https://crm.example.com/api/leads" } }
],
"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"
}
Next steps
- List workflow runs: See this workflow’s execution history.
- Delete workflow: Archive a workflow you no longer need.
Was this page helpful?