---
title: "Cancel Job"
method: POST
path: "/api/v1/jobs/{job_id}/cancel"
tags: ["Jobs"]
---

# Cancel Job

`POST /api/v1/jobs/{job_id}/cancel`

Cancel a submitted video processing job.

Only jobs still in the "processing" state can be cancelled. Cancelling an
already-cancelled job succeeds without changing anything; jobs that have
completed or terminally failed return 409.

When VIDEO_ENDPOINTS_LIVE is False, returns a preview response.

## Path parameters

- `job_id` string, required

## Headers

- `x-api-key` string, nullable
- `League` string, nullable

## Response `200`

Successful Response

- JobStatusResponse
  - `job_id` string, required
  - `state` string, required
  - `start_of_play` string — Actual game start time from dms_main.videos.actual_game_start_time formatted as a video timestamp; empty until it is available.
  - `completed_at` string, nullable — Final worker-start-to-status-complete duration formatted as hh:mm:ss; null until processing is complete.
  - `processing_started_at` string, nullable — UTC (+00:00) timestamp when the worker started processing; null until processing has started.
  - `video_quality` object, nullable — Objective video-quality measurements (resolution and frame_rate) with per-component 0-1 scores. Unknown metadata is represented by null component scores. No grade or show/hide decision is implied.

## Other responses

- `422` — Validation Error

---

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