---
title: "Translate"
method: POST
path: "/lc.mtprovider.translate"
tags: ["Machine Translation Provider"]
---

# Translate

`POST /lc.mtprovider.translate`

Translates the content (text provided in the format specified in the descriptor). This request has a read timeout of 2 minutes.

## Headers

- `TR_ID` string
- `x-lc-signature` string
- `X-LC-AppVersion` string
- `X-LC-ExtensionPointVersion` string
- `X-LC-ExtensionId` string

## Request body

- SdlLcExtensionpointMachinetranslationproviderTranslateRequest — The type of `contents` is based on the `format` specified in the descriptor, `html` or `bcm`. The `projectId`, `sourceFileId` and `targetFileId` are optional.
  - `engineId` string, required — The translation engine identifier provided by the app.
  - `projectId` string — The identifier of the project that uses the app extension.
  - `sourceFileId` string — The identifier of the associated source file.
  - `targetFileId` string — The identifier of the associated target file.
  - `contents` union, required
    - string[] — The input text to translate as html. Provide an array of strings to translate multiple phrases.
    - BCM — An object representing a file in BCM format

## Response `200`

- SdlLcExtensionpointMachinetranslationproviderTranslateResponse — The type of `translations` is based on the `format` specified in the descriptor, `html` or `bcm`.
  - `translations` union
    - string[] — The input text to translate as html. Provide an array of strings to translate multiple phrases.
    - BCM — An object representing a file in BCM format

## Other responses

- `400` — Unexpected message structure or data.
- `401` — Signature validation failed.
- `413` — This should be returned when the payload is too large and the app can't process it. For instance, for the `html` format, the contents list will be halved upon retrying the request.

## Changes

- **2026-01-27** (v1) `9d9d8922a0ce` — 2 info
  - the endpoint scheme security `LanguageCloudJWSToken` was removed from the API
  - added the new optional `header` request parameter `x-lc-signature`
- **2025-11-18** (v1) `ce288dbb23be` — 1 info
  - added the non-success response with the status `413`

[Change history](https://skmtc.dev/rws/apis/app-api/changes/lc.mtprovider.translate/post.md)

---

[API](https://skmtc.dev/rws/apis/app-api.md) · [All operations](https://skmtc.dev/rws/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rws/app-api/revisions/a06e1ee1c99b/schema)