---
title: "Get multiple workflow steps by UID"
method: POST
path: "/workflows-api/v3/accounts/{accountUid}/steps"
tags: ["workflows"]
---

# Get multiple workflow steps by UID

`POST /workflows-api/v3/accounts/{accountUid}/steps`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/workflows-api/v3/accounts/{accountUid}/steps`
- Auth: HTTP bearer

Batch lookup of workflow steps by UID, scoped to the given account.
Every requested UID must belong to the account, or the request fails.

Maximum 1000 UIDs per request.

## Path parameters

- `accountUid` string, required

## Request body

- WorkflowStepUidsCommand: A batch of workflow step UIDs to look up.
  - `workflowStepUids` WorkflowStepUid[], required: Workflow step UIDs to look up. Maximum 1000 entries.

## Response `200`

Workflow steps retrieved.

- WorkflowStepListResponse
  - `response` object
    - `code` 'SUCCESS'
    - `data` object
      - `totalCount` integer
      - `items` WorkflowStepSummary[]
        - `workflowUid` string, required: Workflow unique identifier — 12 lowercase alphanumeric characters.
        - `workflowName` string, required
        - `workflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.
        - `workflowStepName` string, required
        - `workflowStepType` 'AUTHORIZE' | 'PLACEHOLDER' | 'TRANSLATION' | 'POST_TRANSLATION' | 'PUBLISH' | 'ADMIN_APPROVAL' | 'ANALYSIS' | 'WORK_APPROVAL' | 'DECISION' | 'SYSTEM' | 'BACK_TRANSLATION', required: Functional class of a workflow step. `AUTHORIZE` and `PLACEHOLDER` gate content entry; `ANALYSIS` and `SYSTEM` are non-human processing steps; `TRANSLATION`, `POST_TRANSLATION`, `WORK_APPROVAL`, `ADMIN_APPROVAL`, and `BACK_TRANSLATION` are human work steps; `DECISION` branches the route; `PUBLISH` is the terminal step of a route.
        - `workflowStepOrder` integer, required: Position of the step within its route, starting at 1.
        - `claimingEnabled` boolean: Whether translators must claim content before working on it.
        - `assignmentEnabled` boolean: Whether content on this step can be assigned to specific users.
        - `offlineTranslationEnabled` boolean: Whether content on this step can be translated offline.
        - `managedWorkflowStep` boolean: Whether this step is managed by Smartling and cannot be freely reconfigured.
        - `canEditPublishStepEnabled` boolean: Whether editors can edit already-published content from this step.
        - `foundationProfile` string, nullable: Foundation AI translation profile assigned to this step, if any.
        - `actions` WorkflowAction[], required
          - `primary` boolean, required: Whether this is the step's primary (default) forward action.
          - `actionType` 'TRANSLATION_SUBMITTED' | 'EDIT' | 'REVIEW' | 'MOVE' | 'REJECT' | 'POST_MACHINE_REVISION' | 'DECISION' | 'MONOLINGUAL_REVIEW' | 'TRANSCREATION_SUBMITTED' | 'TRANSCREATION_REVIEW' | 'POST_MACHINE_REVISION_PRO' | 'QUALITY_EVALUATION' | 'QUALITY_EVALUATION_PRO' | 'INTERNAL_REVIEW' | 'DESKTOP_PUBLISHING' | 'TRANSLATION_AIT_SUBMITTED' | 'POST_AIT_REVISION' | 'BACK_TRANSLATION' | 'MEDIA_EDIT', required: Type of transition a workflow action represents.
          - `nextWorkflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `403`: The caller does not have permission to perform this operation.

## Changes

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

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/workflows-api/v3/accounts/:accountUid/steps/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)