---
title: "Remove string assignments"
method: POST
path: "/content-assignments-api/v3/projects/{projectId}/strings/remove"
tags: ["content-assignments-v3"]
---

# Remove string assignments

`POST /content-assignments-api/v3/projects/{projectId}/strings/remove`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/content-assignments-api/v3/projects/{projectId}/strings/remove`
- Auth: HTTP bearer

Removes the assignment of up to `500` strings, identified by
`hashCodes`, for a workflow step and locale.

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

Returns `400` when `hashCodes` is empty or exceeds `500` entries,
or `localeId`/`workflowStepUid` is missing or not accessible to
the caller.

## Path parameters

- `projectId` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

## Request body

- TranslationAssignCommand: Identifies the strings to act on, by hashcode, for a workflow step and locale. Used directly by the remove-strings endpoint, and as the base of `TranslationAssignUserCommand` for the assign endpoint.
  - `localeId` string, 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.
  - `workflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.
  - `hashCodes` Hashcode[], required: Hashcodes of the strings to assign or remove. Capped at 500 entries per request.

## Response `200`

Removal queued for async processing.

- TranslationAssignmentProcessResponse: Response envelope for an async assign or remove operation.
  - `response` object, required
    - `code` 'SUCCESS', required
    - `data` object, required
      - `processUid` string, required: Unique identifier of an async process (UUID v4).

## Other responses

- `400`: The request failed validation.
- `401`: Provided credentials are not valid.
- `403`: Caller does not have access to the requested resource.
- `404`: The project, locale, or workflow step does not exist.
- `500`: Unexpected error

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/content-assignments-api/v3/projects/:projectId/strings/remove/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)