---
title: "Move strings to a workflow step"
method: PUT
path: "/workflows-strings-api/v2/projects/{projectId}/movedStrings"
tags: ["workflow-strings"]
---

# Move strings to a workflow step

`PUT /workflows-strings-api/v2/projects/{projectId}/movedStrings`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/workflows-strings-api/v2/projects/{projectId}/movedStrings`
- Auth: HTTP bearer

Moves strings from their current workflow step to a target workflow step, across one or more locale and workflow-step combinations, in a single request.

Each entry in `items` must include at least one hashcode. `targetLocaleId` must be a locale configured in the project, and `targetWorkflowStepUid` must be an existing, accessible workflow step that has that locale configured. Matching strings are moved regardless of their current workflow step.

This endpoint always processes synchronously and returns a `200` response once the move completes. A maximum of 1000 hashcodes total, across all items, may be submitted per request.

## Path parameters

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

## Request body

- WorkflowStringMoveCommand: Batch command to move strings to target workflow steps, across one or more locales.
  - `items` WorkflowStringMoveItem[], required: Per-locale move instructions.
    - `hashcodes` Hashcode[], required: String hashcodes to move. The total number of hashcodes across all items in the request must not exceed 1000.
    - `targetLocaleId` 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.
    - `targetWorkflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.

## Response `200`

Strings moved successfully.

- AsyncProcessResponse
  - `response` object
    - `code` 'SUCCESS': Code of the completed operation.
    - `data` object
      - `processUid` string: Unique identifier of an async process (UUID v4).

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `404`: Project, locale, or workflow step not found or not accessible.

## Changes

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

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/workflows-strings-api/v2/projects/:projectId/movedStrings/put.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)