Sign in

v2

latestOpenAPI 3.0.02026-08-07103189636.5 KB
Jobs

Add file to job

This adds all non-published strings from a file to a job. By default, the file will be added for all locales of the job, but you can change this by specifying targetLocaleIds for the job you wish to add the file into.

Validation rules:

  • A job can contain a maximum of 5000 files.
  • Content can't be added to the job if the job doesn't contain any locales, and the request to add a file doesn't specify any locales.
  • The file (specified by the fileUri) can't be in the process of being uploaded / modified within Smartling. It should complete its upload process before being added to a job.
  • Any targetLocales specified must be valid within the project the job has been created for.

When the system can quickly add the file and its content to the job, it synchronously responds with status 200. When the system cannot quickly add the file and its content to the job, then a 202 response is returned. The response contains a link to check the progress of the request. When a 202 is received, the process of adding the content to the job will not be complete until the returned process has completed.

post/jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}/file/add

Path parameters

projectIdstring required

A unique project identifier. This can be found in the Smartling Dashboard under Account Settings > API.

translationJobUidstring required

Request body

fileUristring

The URI of the file that has been uploaded to Smartling. fileUri is required.

targetLocaleIdsstring[]

The array of localeIds that the file should be added to. If not specified, the file will be added to all locales. If specified, the file will only be added for the locales provided. If the locales were not already part of the job, then the job will be extended to contain the additional locales.

Response

OK