---
title: "Cancel a job"
method: POST
path: "/robots/v0/jobs/{JOB_ID}/cancel"
tags: ["Jobs (v0)"]
deprecated: true
---

# Cancel a job

`POST /robots/v0/jobs/{JOB_ID}/cancel`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/robots/v0/jobs/{JOB_ID}/cancel`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

> **Deprecated.**

Deprecated: use `POST /robots/v1/jobs/{job_id}/cancel` instead. Cancels a job that is currently pending or processing.

## Path parameters

- `JOB_ID` string, required: Robots job ID returned by job creation or listing (rjob_...).

## Response `200`

Job cancelled successfully

- CancelJobResponseV0
  - `data` JobSummaryV0, required
    - `id` string, required: Unique job identifier.
    - `workflow` 'analyze-structure' | 'summarize' | 'generate-contextual-text' | 'moderate' | 'generate-chapters' | 'find-scenes' | 'edit-captions' | 'translate-captions' | 'translate-audio' | 'ask-questions' | 'find-key-moments' | 'generate-engagement-insights' | 'generate-premium-captions' | 'find-best-thumbnails', required: Workflow type that created this job.
    - `status` 'pending' | 'processing' | 'completed' | 'errored' | 'cancelled', required: Current job status.
    - `created_at` integer, required: Unix timestamp (seconds) when the job was created.
    - `updated_at` integer, required: Unix timestamp (seconds) of the job's last state transition (e.g. when it started processing or reached a terminal state).
    - `_links` object, required: Hypermedia links for this job.
      - `self` object, required
        - `href` string, required: URL to this resource.

## Other responses

- `401`: Missing or invalid Mux credentials
- `403`: Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access.
- `404`: Job not found
- `409`: Job is already in a terminal state
- `422`: Invalid request parameters
- `500`: Server error

## Changes

- **2026-10-26** `151835caff06`: 1 info
  - endpoint deprecated
- **2026-10-23** `ed6cb570d60c`: 2 warning
  - added the new `analyze-structure` enum value to the `data/workflow/allOf[#/components/schemas/WorkflowNameV0]/` response property for the response status `200`
  - added the new `generate-contextual-text` enum value to the `data/workflow/allOf[#/components/schemas/WorkflowNameV0]/` response property for the response status `200`
- **2026-10-19** `7e2e5079412d`: 5 info
  - api operation id `cancel-job` removed and replaced with `cancel-job-v0`
  - api tag `Jobs (v0)` added
  - api tag `Jobs` removed
  - added `#/components/schemas/WorkflowNameV0` to the `data/workflow` response property `allOf` list for the response status `200`
  - …1 more
- **2026-10-08** `296f0b01bb84`: 1 breaking, 24 info
  - the `data/workflow` response's property type changed from `string` to no type for status `200`
  - added the non-success response with the status `422`
  - added the optional property `error/messages` to the response with the `401` status
  - added the optional property `error/messages` to the response with the `403` status
  - …21 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/jobs/:JOB_ID/cancel/post.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)