POST/v1/videos/{id}/cancel

Videos — Cancel Job

Cancel a video job that has not yet completed.

Moves a job that has not yet completed to cancelled. A cancelled job is not charged (billing.state: "void").

Response

The job resource after cancellation (HTTP 200):

{
  "id": "vid_01J8TESTVID01",
  "object": "video.job",
  "model": "ltx-2",
  "status": "cancelled",
  "created_at": 1724680000,
  "completed_at": null,
  "expires_at": 1725284800,
  "billing": { "state": "void" },
  "provider_metadata": { "provider": "ltx-staging", "actual_model": "ltx-2.3-distilled" }
}

Cancelling a job already in a terminal state returns the resource unchanged with 200 (idempotent).

Errors

StatusCodeMeaning
404job_not_foundNo job with this id is visible to your organisation.

Plus the standard surface (401, 403, 429, 502, 503) — see Errors.