Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Cancel a batch translation job that is in a NotStarted or Running state. The service makes a best-effort attempt to stop processing. Documents that have already completed translation are retained in the target container and billed normally. Jobs in a terminal state (Succeeded, Failed, Cancelled) cannot be canceled.
HTTP method: DELETE API version: 2026-03-01
Request
DELETE {endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01
Request headers
| Header | Required | Description |
|---|---|---|
Ocp-Apim-Subscription-Key |
Yes | Your Translator resource key from the Azure portal. |
Ocp-Apim-Subscription-Region |
Conditional | Required if you use a regional resource. |
Path parameters
| Parameter | Required | Description |
|---|---|---|
jobId |
Yes | The job ID returned in the operation-location header when you submitted the batch request. |
Example request
curl -X DELETE "{endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01" \
-H "Ocp-Apim-Subscription-Key: {key}"
Response
Response status codes
| Status code | Description |
|---|---|
200 |
Cancel request accepted. The job transitions to Cancelling. |
401 |
Authentication failed. Check your subscription key. |
404 |
Job not found. Verify the jobId. |
409 |
Job is already in a terminal state and cannot be canceled. |
500 |
Internal server error. |