Skip to main content
POST
Cancel video
Requests cancellation for a non-terminal video generation job. Cancellation is provider-dependent. If the selected provider does not support it, Phaseo returns a structured 501 not_implemented_yet response. Completed, failed, cancelled, and expired jobs are already terminal and are not cancelled again.

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

video_id
string
required

The internal Phaseo video job ID (G-...).

Response

501 - application/json

Video cancellation is disabled

error
required
Example:

"error_type"

ok
boolean
Example:

false

message
string
Example:

"Human-readable error message"

description
string
Example:

"Additional error details."

generation_id
string
Example:

"G-abc123"

status_code
integer
Example:

502

error_type
enum<string>
Available options:
user,
system
Example:

"system"

error_origin
enum<string>
Available options:
user,
gateway,
upstream
Example:

"upstream"

reason
string
Example:

"all_candidates_failed"

attempt_count
integer
Example:

2

failed_providers
string[]
Example:
failed_statuses
integer[]
Example:
upstream_error
object
failure_sample
object[]
provider_failure_diagnostics
object
routing_diagnostics
object
provider_candidate_diagnostics
object
provider_enablement
object
missing_pricing_providers
string[]
provider_payment_required_provider
string
Example:

"openai"

provider_payment_required_support_notice
string
Example:

"Our upstream provider billing appears to be unavailable. If this persists, contact support."

details
object[]
Last modified on July 26, 2026