---
title: "Add strings to job"
method: POST
path: "/jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}/strings/add"
tags: ["Jobs"]
---

# Add strings to job

`POST /jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}/strings/add`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}/strings/add`
- Auth: HTTP bearer

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.

## Path parameters

- `projectId` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
- `translationJobUid` string, required: Translation job unique identifier — 12 lowercase alphanumeric characters.

## Request body

- AddStringsJobRequest: The payload to use when adding strings to a job.
  - `hashcodes` Hashcode[]: 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.
  - `moveEnabled` boolean: (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.
  - `targetLocaleIds` LocaleId[]: The array of `localeId`s 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.

## Response `200`

OK

- AddContentSuccessFailCountJobResponse
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `failCount` integer: The number of strings per locale that could not be added to the job. As for now the only reason of failure is that strings are already in another job.
      - `successCount` integer: The number of strings per locale added to the job.

## Other responses

- `202`: ACCEPTED
- `400`: Validation error response
- `401`: Provided credentials are not valid.
- `429`: Too many simultaneous API requests.
- `500`: Unexpected error

## Changes

- **2026-10-17** `2cd7a8215799`: 12 breaking, 1 info
  - added the pattern `^[a-z0-9]{12}$` to the `path` request parameter `translationJobUid`
  - added the pattern `^[a-z0-9]{9}$` to the `path` request parameter `projectId`
  - added the pattern `^[a-f0-9]{32}$` to the request property `hashcodes/items/`
  - added the pattern `^[a-z]{2}(-[A-Z]{2})?$` to the request property `targetLocaleIds/items/`
  - …9 more
- **2026-08-06** `ae422098d9c5`: 2 breaking
  - the `response/allOf[subschema #2]/data/failCount` response's property type changed from `string` to `integer` for status `200`
  - the `response/allOf[subschema #2]/data/successCount` response's property type changed from `string` to `integer` for status `200`

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/jobs-api/v3/projects/:projectId/jobs/:translationJobUid/strings/add/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)