Skip to main content
POST
/
videos
/
{video_id}
/
cancel
Cancel video
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.phaseo.app/v1/videos/{video_id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "error": "error_type",
  "ok": false,
  "message": "Human-readable error message",
  "description": "Additional error details.",
  "generation_id": "G-abc123",
  "status_code": 502,
  "error_type": "system",
  "error_origin": "upstream",
  "reason": "all_candidates_failed",
  "attempt_count": 2,
  "failed_providers": [
    "google-ai-studio",
    "openai"
  ],
  "failed_statuses": [
    403,
    429
  ],
  "upstream_error": {
    "code": "PERMISSION_DENIED",
    "message": "The caller does not have permission.",
    "description": "<string>",
    "param": "<string>"
  },
  "failure_sample": [
    {
      "provider": "<string>",
      "type": "<string>",
      "status": 123,
      "upstream_error_code": "<string>",
      "upstream_error_message": "<string>",
      "upstream_error_description": "<string>",
      "upstream_error_param": "<string>",
      "upstream_payload_preview": "<string>",
      "retryable": true
    }
  ],
  "provider_failure_diagnostics": {
    "category": "credentials_not_configured",
    "hint": "<string>",
    "provider": "<string>"
  },
  "routing_diagnostics": {
    "filterStages": [
      {
        "stage": "<string>",
        "beforeCount": 123,
        "afterCount": 123,
        "droppedProviders": [
          {
            "providerId": "<string>",
            "reason": "<string>"
          }
        ]
      }
    ]
  },
  "provider_candidate_diagnostics": {
    "totalProviders": 123,
    "supportsEndpointCount": 123,
    "candidateCount": 123,
    "droppedUnsupportedEndpoint": [
      "<string>"
    ],
    "droppedMissingAdapter": [
      {
        "providerId": "<string>",
        "endpoint": "<string>"
      }
    ]
  },
  "provider_enablement": {
    "capability": "<string>",
    "providersBefore": [
      "<string>"
    ],
    "providersAfter": [
      "<string>"
    ],
    "dropped": [
      {
        "providerId": "<string>",
        "reason": "<string>"
      }
    ]
  },
  "missing_pricing_providers": [
    "<string>"
  ],
  "provider_payment_required_provider": "openai",
  "provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
  "details": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt

Use this file to discover all available pages before exploring further.

Reserves the public cancel endpoint while provider-level cancellation support is standardized. The endpoint exists today, but currently returns a structured 501 not_implemented_yet error while cancellation behavior is finalized across providers. Treat cancellation as not yet generally available across the public video surface even though the route and SDK method names exist.

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

video_id
string
required

The internal AI Stats video job ID (G-...).

Response

501 - application/json

Video cancellation is currently 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:
["google-ai-studio", "openai"]
failed_statuses
integer[]
Example:
[403, 429]
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 May 6, 2026