Overview
UseDELETE /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 usingseedance-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
string
required
The async task ID returned by the create request or embedded in
poll_url.Response
string
Canonical async task identifier.
string
Async task identifier alias.
string
Preferred polling URL for the task. It remains valid after cancellation.
string
Task status. A successfully cancelled task is returned as
failed with cancelled: true for compatibility with existing status values.boolean
true when the task was cancelled before execution.string
Cancellation marker. The value is
cancelled when cancellation succeeds.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
Response