Skip to main content

apps/mthive/translate/files (post)

This method submits one or more files for translation using the MT Hive service.

Please note that the file or files need to be uploaded first. Only then would you call the present method. See below for details. 


(POST) /api/apps/mthive/translate/files


Parameters are included as a JSON object in the request body:


Mandatory. A list of the previously uploaded files that you submit for translation.

Each file is listed with its file token and the file format ID to use.


    "token": "3e896bb7812d48e780a119adf39c6dd0",
    "parserId": 1235
    "token": "3e896bb7812d48e780a119adf39c6dd0",
    "parserId": 231

See below on how to upload files and obtain the file tokens.

object[], Mandatory

The source language code. Make sure to only use source languages according to the MTHive configuration.

string, Mandatory
trgMandatory. The target language code. Make sure to only use target languages according to the MT Hive configuration.string, Mandatory

The option index for the selected Mt Hive configuration (Zero-based index).

MT Hive lets you specify multiple profiles, see "Settings" > "MT Hive" (see Administration of MT Hive)

int, Mandatory


The API requires a file token and a format ID. The former references a previously uploaded file. The latter the file filter configuration ID (or format ID) to use for processing.

To upload a file use this API method: media/upload. It returns a token that you would include with the payload (see files above).

The parserId field designates the file filter configuration to use to process the file. You find the available options for each type of file in the configuration under node /options/{option index}/formats/{file type}/foptions[*]/foption


Here a single option (2266) is available for Microsoft Word files. Since the configuration lists the supported file extensions, it is relatively easy to automate a lookup mechanism in code.

Note that multiple options may be available for a specific type of file. In such a case, MT Hive should propose both options to the user and preselect the first option by default.

Using an ID that does not exist will result in a failure.


The method executes asynchronously. It returns the operation ID which is a number.



You would then wait a few seconds and request a detailed operation status using This will return the status. You need to poll the method and wait 2 to 5 seconds in between polls until the status is Finished or Failed. Please read this page for a detailed explanation: Asynchronous operation

  "trm": {


The api may return errors if:

  • You are not subscribed to MT Hive or MT Hive is not configured
  • The languages or option are not in the configuration. Note that this can also happen in the case of a language detection
  • The text exceeds the maximum length

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.