SMsmartling
content-assignments-v3

Assign strings to a user

Changed on

Assigns up to 500 strings, identified by hashCodes, to a user for a workflow step and locale. Content is assigned directly by hashcode; there's no task-bucket or claiming concept.

The operation runs asynchronously. Poll the process status endpoint with the returned processUid for progress and outcome.

The target user must have a workflow assignment for the step and locale before they can be assigned to content in that step.

Translation Resource Managers (TRMs), Agency Account Owners (AAOs), and other roles with access to the endpoint can assign any user who has that workflow assignment. A Translation Resource (TR) can only assign content to themselves, and only when claiming is enabled for the account.

Returns 400 when: hashCodes is empty or exceeds 500 entries; localeId or workflowStepUid is missing or not accessible to the caller; userUid is missing or does not resolve to a known user; the target user has no workflow assignment for the step and locale; the caller is a TR and userUid is not the caller's own UID; the caller is a TR and claiming is not enabled for the account; or the workflow is not configured for the locale.

post/content-assignments-api/v3/projects/{projectId}/strings/assign

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.

Request body

localeIdstring required

Locale identifier. Either a 2-letter language code (en) or a language-region pair (en-US). The language part is always lowercase; the region part is always uppercase.

workflowStepUidstring required

Workflow step unique identifier — 12 lowercase alphanumeric characters.

hashCodesHashcode[] required

Hashcodes of the strings to assign or remove. Capped at 500 entries per request.

userUidstring required

Unique identifier of a user — 12 lowercase alphanumeric characters.

Example request

{
  "localeId": "fr-FR",
  "workflowStepUid": "7564fc097a85",
  "hashCodes": [
    "d41d8cd98f00b204e9800998ecf8427e"
  ],
  "userUid": "99b0662fbae1"
}

Response

Assignment queued for async processing.

Example response

{
  "response": {
    "data": {
      "processUid": "097ecbc2-8f1b-4ce5-b5c4-d48c3f0e5d9e"
    }
  }
}

Changes