Skip to main content
POST
Stops a task that is still pending or processing. A task that already reached a terminal state cannot be cancelled.
Video created through POST /v2/videos is cancelled with DELETE /v2/videos/{id} instead.
string
required
Task ID, as returned when the task was created.
The response is the same task object returned by GET /v1/tasks/{task_id}, with status set to cancelled.

Billing

Cancelling does not refund work the upstream provider already performed. For video, the quote is taken when the task is created — see Pricing.

Errors

Same envelope as Errors.
Unknown task ID, or a task belonging to another account.
The task already reached completed, failed, or cancelled.