---
title: "Submit a single document translation request to the Document Translation service"
method: POST
path: "/document:translate"
---

# Submit a single document translation request to the Document Translation service

`POST /document:translate`

Use this API to submit a single translation request to the Document Translation Service.

## Query parameters

- `api-version` string, required
- `sourceLanguage` string
- `targetLanguage` string, required
- `category` string
- `allowFallback` boolean
- `translateTextWithinImage` boolean

## Headers

- `x-ms-client-request-id` string, uuid

## Response `200`

The request has succeeded.

- string, binary

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01-preview) `a4e049ab474e` — 1 info
  - added the new optional `query` request parameter `translateTextWithinImage`
- **2026-07-13** (2023-11-01-preview) `2a29f2b714b8` — 1 info
  - api operation id `DocumentTranslate` removed and replaced with `DocumentTranslationOperations_DocumentTranslate`

[Change history](https://skmtc.dev/azure/apis/translation-documenttranslation/changes/document:translate/post.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)