Upload Translations

Upload existing translations to your Crowdin project.


POST https://api.crowdin.com/api/project/{project-identifier}/upload-translation?key={project-key}


Name Value Description
filesrequired array Translated files array. Array keys should contain file names in Crowdin.
Note! 20 files max are allowed to upload per one time file transfer.
languagerequired string Target language. With a single call it's possible to upload translations for several files but only into one of the languages.
import_duplicatesoptional bool Defines whether to add translation if there is the same translation previously added. Acceptable values are: 0 or 1. Default is 0.
import_eq_suggestionsoptional bool Defines whether to add translation if it is equal to source string at Crowdin. Acceptable values are: 0 or 1. Default is 0.
auto_approve_importedoptional bool Mark uploaded translations as approved. Acceptable values are: 0 or 1. Default is 0.
formatoptional string Specify this parameter if translations are uploaded to the project in XLIFF file format. Acceptable value is: xliff
To download XLIFF file for offline translation, apply the Export File method.
branchoptional string The name of related version branch (Versions Management).
jsonoptional string May not contain value. Defines that response should be in JSON format.
jsonpoptional string Callback function name. Defines that response should be in JSONP format.
project-identifierrequired string Should contain the project identifier.
project-keyrequired string Project API key.


If successful, this method returns a XML structure, as it is shown below.
  <?xml version="1.0" encoding="ISO-8859-1"?>

Unsuccessful response sample:
  <?xml version="1.0" encoding="ISO-8859-1"?>
      API key is not valid

The following request is partly successful because for all the file formats that do not have defined structure (such as: Generic XML, HTML, Plain Text, Markdown, OpenOffice, Microsoft Office, Adobe InDesign, Adobe FrameMaker, Webxml) the translations upload is not possible.
 <?xml version="1.0" encoding="ISO-8859-1"?>


curl \
  -F "files[strings.xml]=@strings.fr.xml" \
  -F "language=fr" \
  -F "auto_approve_imported=1" \