---
title: "Cancel Video"
method: POST
path: "/api/v1/videos/{video_uuid}/cancel"
tags: ["Videos"]
---

# Cancel Video

`POST /api/v1/videos/{video_uuid}/cancel`

Cancel an in-flight Glory League video submission.

Marks the submission terminally and best-effort halts the league processing
pipeline. Only submissions still pending/processing can be cancelled; an
already-cancelled submission returns success idempotently, and
completed/failed ones return 409.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response without DB writes.

## Path parameters

- `video_uuid` string, required

## Headers

- `x-api-key` string, required — Required API key issued by Preciser.
- `League` string, required — Required tenant/database selector, for example pitchbio-master.

## Response `200`

Successful Response

- GLVideoCancelResponse — Response schema for Glory League video cancellation.
  - `success` boolean, required — Whether the cancellation was accepted
  - `video_uuid` string, required — The video UUID
  - `status` string, required — Resulting status (always 'cancelled' on success)
  - `message` string, required — Human-readable detail
  - `credit_refunded` boolean, required — True only when cancellation happened before game info was submitted and the reserved credit is available again

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `9b0abde08b06` — 4 breaking, 2 info
  - the `header` request parameter `League` became required
  - the `header` request parameter `x-api-key` became required
  - `header` request parameter `League` list-of-types was narrowed by removing types `null`
  - `header` request parameter `x-api-key` list-of-types was narrowed by removing types `null`
  - …2 more
- **2026-08-25** `cd89acfd6adf` — 1 info
  - added the required property `credit_refunded` to the response with the `200` status

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/videos/:video_uuid/cancel/post.md)

---

[API](https://skmtc.dev/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.dev/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/revisions/24ef9111adac/schema)