Page Comparison

token

Use API media/upload to upload a file. It returns the token to be included here. Note: The upload of your file or files must be done prior to calling the present method.

If you need to upload multiple files to get multiple tokens, use the multi-upload: media/upload/multi

string, Mandatory

name

The file name, with or without folders. The file will be stored with this name & folders in the project. Some valid filenames:

my-file.docx
marketing/section1/presentation.ppt
marketing\\section1\\presentation.ppt
strings.product.json

Note: When using “\” make sure to escape with “\\”. This is not necessary when using the forward “/” as folder separator.

string, Mandatory

Optional parameters

formatId

Optional document format configuration to be used for extracting content from the file. See Document formats to enumerate all existing file formats.

Normally, you do not need to override the defaults: By default, the system selects the filter from the project’s File Filter configuration.

int?, Optional

disableMt

Optional, default is false. If you explicitly want to prevent machine translation when preparing the file, set this property to true. Machine translation is enabled or disabled in the project’s word count profile.

bool, Optional

reference

Optional sender ID for the document. For example, this can hold an identifier you assign to the document outside of Wordbee.

string?, Optional

comments

Optional comments added to the document and shown in the translation editor.

string?, Optional

attachments

Optional array of files to attach to the document. This can be screenshots, reference material or more. Up to 10 files can be attached. See details below.

You can also upload attachments at a later time using Manage attachments

object[]?, Optional

token

Use API media/upload to upload a file. It returns the token to be included here. Note: The upload of your file or files must be done prior to calling the present method.

If you need to upload multiple files to get multiple tokens, use the multi-upload: media/upload/multi

string, Mandatory

name

The attachment file name, with or without folders.

string, Mandatory

locale

The language code of the attachment. Must be a source or a target language of the present request.

string, Mandatory