Skip to main content
POST
/
api
/
workflows
/
runs
/
{id}
/
cancel
Cancel Workflow Run
curl --request POST \
  --url https://encrata.com/api/workflows/runs/{id}/cancel \
  --header 'Authorization: Bearer <token>'

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 run ID to cancel.

Example request

curl -X POST "https://encrata.com/api/workflows/runs/run_def456/cancel" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

{
  "success": true,
  "message": "Run cancelled",
  "id": "run_def456",
  "status": "cancelled"
}
Only runs with status queued or running can be cancelled. Already completed or failed runs cannot be cancelled.