SMsmartling
Jobs

Add strings to job

Changed on

Adding strings to a job is useful if you don't manage strings / content through files, but instead need to add strings by some other means other than files.

When strings are successfully added to a job, a 200 status is returned. When the system can't quickly add strings to the job, a 202 response status is returned. The response contains a link and processUid 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}/strings/add

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

Example:84c012a33

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

translationJobUidstring required

Translation job unique identifier — 12 lowercase alphanumeric characters.

Example:j45v1uvsi3tx

Request body

hashcodesHashcode[]

The array of hashcodes to use to add to the job. The hashcodes must exist within Smartling, for the project, in order to be added to a job. Hashcodes are required when adding strings to a job. Hashcodes are limited to 1000 per API call.

moveEnabledboolean

(Optional), default is false. A string for a locale can only be in one job. If the string identified in the request is already in a job for a locale then it won't be added. However, moveEnabled=true can be specified, and in this case, the string will be moved into the specified job.

targetLocaleIdsLocaleId[]

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

Example request

{
  "hashcodes": [
    "d41d8cd98f00b204e9800998ecf8427e"
  ],
  "targetLocaleIds": [
    "fr-FR"
  ]
}

Response

OK

Changes

  • 2cd7a8215799Revision changes
    • breaking

      added the pattern ^[a-z0-9]{12}$ to the path request parameter translationJobUid

    • breaking

      added the pattern ^[a-z0-9]{9}$ to the path request parameter projectId

    • breaking

      added the pattern ^[a-f0-9]{32}$ to the request property /

    • breaking

      added the pattern ^[a-z]{2}(-[A-Z]{2})?$ to the request property /

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • info

      the // response's property pattern ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ was added for the status

  • ae422098d9c5Revision changes
    • breaking

      the /// response's property type changed from string to integer for status

    • breaking

      the /// response's property type changed from string to integer for status