Cancel a run

POST

workflows

{id}

runs

{runId}

cancel

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "623e4567-e89b-12d3-a456-426614174000",
  "workflowId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "cancelled",
  "completedAt": "2026-10-11T09:05:00Z"
}

This endpoint is for the VIP plan only. Other plans get a 403. See Plan access.

Stop a run that is still going or has not started. It answers with the run’s id, workflowId, status and completedAt. A run that is waiting, or has finished, gets 409.

Path Parameters

string

required

The workflow’s id.

string

required

The run’s id.

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "623e4567-e89b-12d3-a456-426614174000",
  "workflowId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "cancelled",
  "completedAt": "2026-10-11T09:05:00Z"
}

Errors

Status	When
`400`	The workflow id or run id is not a valid UUID.
`402`	The account has no plan, or its subscription is not active.
`403`	Your plan is not VIP.
`404`	No workflow or run has this id, or it is not in this key’s scope.
`409`	The run is waiting or has finished, so it can’t be cancelled.

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "623e4567-e89b-12d3-a456-426614174000",
  "workflowId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "cancelled",
  "completedAt": "2026-10-11T09:05:00Z"
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Cancel a run

Path Parameters

Errors