---
title: "Cancel a currently processing or queued translation"
method: DELETE
path: "/document/batches/{id}"
---

# Cancel a currently processing or queued translation

`DELETE /document/batches/{id}`

Cancel a currently processing or queued translation.
A translation will not be
cancelled if it is already completed or failed or cancelling. A bad request
will be returned.
All documents that have completed translation will not be
cancelled and will be charged.
All pending documents will be cancelled if
possible.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- TranslationStatus — Translation job status response
  - `id` string, required — Id of the translation operation.
  - `createdDateTimeUtc` string, date-time, required — Operation created date time
  - `lastActionDateTimeUtc` string, date-time, required — Date time in which the operation's status has been updated
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Cancelling' | 'ValidationFailed', required — List of possible statuses for job or document
  - `error` TranslationError — This contains an outer error with error code, message, details, target and an inner error with more descriptive details.
    - `code` 'InvalidRequest' | 'InvalidArgument' | 'InternalServerError' | 'ServiceUnavailable' | 'ResourceNotFound' | 'Unauthorized' | 'RequestRateTooHigh', required — Enums containing high level error codes.
    - `message` string, required — Gets high level error message.
    - `target` string — Gets the source of the error. For example it would be "documents" or "document id" in case of invalid document.
    - `innerError` InnerTranslationError — New Inner Error format which conforms to Cognitive Services API Guidelines which is available at https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. This contains required properties ErrorCode, message and optional properties target, details(key value pair), inner error(this can be nested).
      - `code` string, required — Gets code error string.
      - `message` string, required — Gets high level error message.
      - `target` string — Gets the source of the error. For example it would be "documents" or "document id" in case of invalid document.
      - `innerError` InnerTranslationError — recursive
  - `summary` StatusSummary, required — Status Summary
    - `total` integer, required — Total count
    - `failed` integer, required — Failed count
    - `success` integer, required — Number of Success
    - `inProgress` integer, required — Number of in progress
    - `notYetStarted` integer, required — Count of not yet started
    - `cancelled` integer, required — Number of cancelled
    - `totalCharacterCharged` integer, required — Total characters charged by the API
    - `totalImageScansSucceeded` integer — Total image scans charged by the API
    - `totalImageScansFailed` integer — Total image scans failed
    - `totalImageCharged` integer — Total images charged by the API

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01-preview) `2a29f2b714b8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/translation-documenttranslation/changes/document/batches/:id/delete.md)

---

[API](https://skmtc.dev/azure/apis/translation-documenttranslation.md) · [All operations](https://skmtc.dev/azure/apis/translation-documenttranslation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/translation-documenttranslation/revisions/f29cf344b9da/schema)