curl -X PUT "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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" } }
]
}'
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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,
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-06-01T12:00:00Z"
}
Workflows
Update Workflow
Replace a workflow’s full definition. Dashboard-only, and a full replacement.
PUT
/
api
/
workflows
/
{id}
curl -X PUT "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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" } }
]
}'
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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,
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-06-01T12:00:00Z"
}
This endpoint is not available on the developer API.
PUT /api/workflows/{id}
is dashboard-only. Calling it on https://developer.encrata.com with an API
key returns 404 with the body
"That endpoint is not available on the developer API."This page documents the request shape for reference only.PUT is a full replacement, not a partial patch. Any field you omit is
written as empty. Omitting
steps wipes the workflow’s steps; omitting
trigger wipes its trigger. Always send the complete definition.Read the workflow first with
Get workflow, change the fields you
want, and send the whole object back.Authentication
Requires a dashboard session (JWT) onhttps://api.encrata.com.
Request
string
required
The workflow’s UUID.
string
required
Workflow name. Send the current value if you are not changing it.
string
required
Description. Send the current value if you are not changing it.
string
required
active, paused, draft, or archived.object
required
The complete trigger configuration.
array
required
The complete step list. Omitting this clears every step.
array
The complete edge list. Omitting this clears every edge.
Example request
This sends the full definition, changing onlyname and status.
curl -X PUT "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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" } }
]
}'
Response
Returns the updated workflow.curl -X PUT "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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" } }
]
}'
{
"id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"user_id": "3f8c1a22-9e41-4b0d-8d77-5a6b7c8d9e01",
"name": "Updated pipeline",
"description": "Enrich emails then send to CRM",
"status": "paused",
"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,
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-06-01T12:00:00Z"
}
The workflow object carries no
version field. Version history is
dashboard-only.Was this page helpful?