Skip to main content


Upload a file to the server and obtain a token for the file. The token can then be used with other API methods to apply an operation with the file.

The API method accepts "multipart" uploads only.


(POST) /api/media/upload?filename=&maxsize=


The URL parameters are:


Optional file name. If not specified, the system uses the name specified with the multi-part upload.

Make sure to set the file extension so that the system know the type of the file.

Optional, string


Optionally restrict the maximum size allowed for the upload. This is useful if you implement user interfaces and you want to users to upload smaller files only.

Note that the system also sets a hard size limit.

Optional, int

The file itself must be submitted with the request body as a multipart upload.

The content type of your request must be "multipart/form-data".


The message body contains a JSON object:


A newly created token for file.

result.nameThe file name.string


See this example:

  "result": {
      "token": "XXXXXXXXXXXX",
      "name": "myfile.docx"


In Postman choose form-data and set the field type to File. Then select a file from your PC. The binary option will not work since a "multi-part" payload is expected.

JavaScript errors detected

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

If this problem persists, please contact our support.