Skip to main content

​
Overview

Use DELETE /v1/tasks/{id} to cancel an asynchronous task that has not started running yet. Use the same task ID from the create response or the returned poll_url.

​
Supported Tasks

Cancellation is currently supported for queued Seedance video tasks using seedance-1.5-pro, seedance-2.0, or seedance-2.0-fast when the provider selected for that task supports cancellation. Tasks that are already processing/running cannot be cancelled. Completed, failed, expired, or unsupported tasks remain queryable for status and billing reconciliation.

​
Path Parameters

​
id
string
required
The async task ID returned by the create request or embedded in poll_url.

​
Response

​
id
string
Canonical async task identifier.
​
task_id
string
Async task identifier alias.
​
poll_url
string
Preferred polling URL for the task. It remains valid after cancellation.
​
status
string
Task status. A successfully cancelled task is returned as failed with cancelled: true for compatibility with existing status values.
​
cancelled
boolean
true when the task was cancelled before execution.
​
cancellation_status
string
Cancellation marker. The value is cancelled when cancellation succeeds.
​
error
string
Cancellation reason or task failure message.

​
Error Behavior

400 unsupported_task_cancel means the task type, provider, or model does not support cancellation. 409 task_not_cancellable means the task is already processing, terminal, or otherwise no longer cancellable. 403 means the API key cannot access the task.

​
Example

curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "cancelled": true,
  "cancellation_status": "cancelled",
  "error": "Task cancelled before execution"
}