Skip to main content
POST
/
api
/
workflows
/
{id}
/
run
Run Workflow
curl --request POST \
  --url https://encrata.com/api/workflows/{id}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "input": {}
}'

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

​
id
string
required
The workflow ID to execute.
​
input
object
Input data passed to the first step of the workflow.
​
Idempotency-Key
string
Optional. Prevents duplicate runs if the same key is sent again within 24 hours.

​
Example request

curl -X POST "https://encrata.com/api/workflows/wf_abc123/run" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: run-20260601-001" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "email": "jane@company.com" } }'

​
Response

Returns the created run object. 
{
  "id": "run_def456",
  "workflow_id": "wf_abc123",
  "status": "running",
  "input": { "email": "jane@company.com" },
  "started_at": "2026-06-01T10:00:00Z"
}

​
Rate Limits

Workflow runs are limited to 60 per minute per user. Exceeding this returns 429 Too Many Requests.

​
Credits

Each enrichment step consumes credits at the standard API rate. Non-enrichment steps (condition, delay, webhook, transform) are free.