Skip to main content

API - Send source content

The purpose of this method is to send original content (or files) to translate to the project input directory. The method sends one file.

This method is equivalent to copying a file to the project's "IN" directory.


(PUT) /api/files/file?token=&locale=&folder=&filename=

Please note that this is an HTTP PUT and not a GET action. The binary data of the file must be included in the message body.

Please note that multi-part attachments are not supported.


Parameters are:


The session token obtained when connecting.


The source language. This must correspond to the project source language code.

Language codes are ISO 2 letter codes such as “en”, “fr”, “en-GB”, “en-US”, etc.


The relative path of the file including sub-directories.

  • This can be a simple file name like “myfile.xml”.
  • Or, it can include directories such as “folder1\folder2\myfile.xml”.

Note the use of backslash separators as it is common on Windows systems.

The file will be saved to the project input directory with the specified sub-directories. Sub-directories are created if these do not yet exist.

Using sub-directories is useful if you want to organize files into folders.



Folder name


Add the binary content of the file to the message body.

Set content type to "Stream", such as in: Content-Type: Stream

Do not use multi-part MIME contents as this is not supported by the Beebox.

The file will be saved to the project input directory and then picked up from there by the Beebox. Always make sure to verify the HTTP status to make sure that your operation succeeded.

Example: If you specify the filename “folder1\myfile.xml”, the file will be saved to “c:\beebox\{project id}\in\folder1\myfile.xml”.


The method returns no result. An HTTP status of 204 indicates success.

Other HTTP status values indicate an error.


The actual content you include with your API call can be of any encoding (code page).

You can, but do not need, to "normalize" original text content to UTF-8 or similar. The Beebox, if properly configured, is capable of reading any code pages.

If you actually generate text content on the fly in PHP, Java etc. it is best practice to encode in UTF-8 for maximum language support.

If you send files from disk, it is best to send as binary content. Binary formats such as Microsoft Word or Adobe InDesign are sent unchanged obviously.


You send the Japanese file "pages\page1.html":


            MESSAGE BODY:
            The original Japanese html code (UTF-8 or other code page)
 Internally, the file will be saved to the Beebox project directory in this location:

c:\Beebox\{project key}
The "pages" sub directory is a folder included in the "filename" parameter above.

The c:\Beebox root directory may be different in your setup. 


The following screenshots give an idea how to use the Google Chrome plugin "Postman" to submit a file. We suppose that you already have obtained a connection token.

First, choose the "PUT" method, insert the URL with the different parameters.

Second, click the "Headers" panel and set the Content-Type to Stream (first letter capitalized):

JavaScript errors detected

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

If this problem persists, please contact our support.