Cancel Queued Run

Cancel a workflow run that is still in the queue before execution starts.

POST /workflow-service/api/public/v1/workflow-runs/{runId}/cancel

Cancel Queued Run

cURL

curl --request POST \
  --url https://api.slatehq.ai/workflow-service/api/public/v1/workflow-runs/{runId}/cancel \
  --header 'Authorization: <authorization>'

200

{
  "run_id": "<string>",
  "status": "<string>",
  "completed_at": "<string>"
}

Cancels a workflow run that has not started executing yet. Only runs with status QUEUED can be canceled.

Once a run moves to STARTING, RUNNING, or any terminal status, cancellation is not possible. The API returns a 409 error.

Parameters

runId · string · required

Unique identifier for the workflow run to cancel. Returned as run_id when you create a run.

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

Response

Returns 200 OK with the canceled run details.

run_id · string · required

Unique identifier for the canceled run.

status · string · required

Updated status. Always CANCELED on success.

completed_at · string · required

Timestamp when the run was canceled. ISO 8601 format.

Example

cURL

curl -s -X POST "https://api.slatehq.ai/workflow-service/api/public/v1/workflow-runs/8c5e0f8a-2b35-4c1f-9b6a-9d0a6b3c1f4e/cancel" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "run_id": "8c5e0f8a-2b35-4c1f-9b6a-9d0a6b3c1f4e",
  "status": "CANCELED",
  "completed_at": "2026-01-27T01:24:00.000Z"
}

Status codes

Status	Description
200	Run canceled.
401	Missing or invalid Bearer token. See Authentication.
404	Run not found. The runId does not exist or does not belong to this token.
409	Run is not cancelable. The run has already moved past the QUEUED status.
500	Internal server error.

What’s next

• Create Workflow Run — Trigger a new workflow run.
• Get Run Status — Check run progress and results.