---
title: "Cancel a batch job"
method: POST
path: "/v1/batch-jobs/{batchJobId}/cancel"
tags: ["Batch Processing"]
---

# Cancel a batch job

`POST /v1/batch-jobs/{batchJobId}/cancel`

Cancels a batch job. This will stop the batch job from being processed further.

## Path parameters

- `batchJobId` string, required

## Request body

- GatewayServiceCancelBatchJobBody

## Response `200`

A successful response.

- V1CancelBatchJobResponse
  - `batchJobId` string
  - `state` 'BATCH_JOB_STATE_UNSPECIFIED' | 'BATCH_JOB_STATE_ERROR' | 'BATCH_JOB_STATE_INITIALIZED' | 'BATCH_JOB_STATE_QUEUED' | 'BATCH_JOB_STATE_PREPROCESSING' | 'BATCH_JOB_STATE_PREPROCESSED' | 'BATCH_JOB_STATE_SUBMITTED' | 'BATCH_JOB_STATE_POSTPROCESSING' | 'BATCH_JOB_STATE_POSTPROCESSED' | 'BATCH_JOB_STATE_COMPLETED' | 'BATCH_JOB_STATE_CANCELLED'
  - `error` V1BatchJobError
    - `errorCode` 'BATCH_JOB_ERROR_UNSPECIFIED' | 'BATCH_JOB_ERROR_INVALID_INPUT_FILE' | 'BATCH_JOB_ERROR_INVALID_POLICY' | 'BATCH_JOB_ERROR_INVALID_POLICY_VERSION' | 'BATCH_JOB_ERROR_INVALID_PRIORITY'
    - `errorMessage` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `499` — Precheck Failures (Canceled)
- `default` — An unexpected error response.

---

[API](https://skmtc.net/clavata/apis/clavata-public-api-v1.md) · [All operations](https://skmtc.net/clavata/apis/clavata-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clavata/clavata-public-api-v1/revisions/7d66607e1ab6/schema)