---
title: "List workflows"
method: POST
path: "/workflows-api/v3/accounts/{accountUid}/workflows"
tags: ["workflows"]
---

# List workflows

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

## Request

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

Returns the workflows in the account that the authenticated user is
allowed to use for content assignment or authoring, together with
their steps and the locale coverage of each step.

All filter fields are optional. Regardless of which filters are
supplied, each returned workflow includes its full step/action
snapshot.

`limit` is clamped to the range 1-500 (default 100). Neither the
returned workflows nor each workflow's `workflowSteps` are sorted in
any guaranteed order.

## Path parameters

- `accountUid` string, required

## Request body

- UserWorkflowFilterCommand: Optional filters for listing the workflows the current user may use. Regardless of which filters are supplied, each returned workflow includes its full step/action snapshot.
  - `projectId` string: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
  - `keyword` string: Filter by workflow name (case-insensitive substring match).
  - `localeIds` LocaleId[]: Restrict to workflows covering any of these locales.
  - `workflowUids` WorkflowUid[]: Restrict to these workflow UIDs.
  - `workflowStepUids` WorkflowStepUid[]: Restrict to workflows containing any of these steps.
  - `localePairManagementType` 'CUSTOM' | 'PROJECT' | 'LOCKED': How a workflow's locale-pair coverage is managed: `CUSTOM` (account-level workflow with its own explicit locale pairs), `PROJECT` (project-level workflow), or `LOCKED` (locale pairs fixed by the system).
  - `limit` integer: Maximum number of results. Clamped to the range 1-500.

## Response `200`

Allowed workflows retrieved.

- UserWorkflowListResponse
  - `response` object
    - `code` 'SUCCESS'
    - `data` object
      - `totalCount` integer
      - `items` UserWorkflow[]
        - `workflowUid` string, required: Workflow unique identifier — 12 lowercase alphanumeric characters.
        - `workflowName` string, required
        - `managedWorkflow` boolean
        - `contentTypeUid` string, nullable
        - `projectId` string, nullable: Project this workflow belongs to. `null` for account-level workflows.
        - `localePairs` LocalePairGroup[], nullable
          - `sourceLocaleId` 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.
          - `targetLocaleIds` LocaleId[], required
        - `workflowSteps` UserWorkflowStep[]
          - `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, nullable: Position of the step within its route. `null` when the caller cannot see the full workflow.
          - `claimingEnabled` boolean: Whether translators must claim content before working on it.
          - `assignmentEnabled` boolean: Whether content on this step can be assigned to specific users.
          - `translatorCanEditEnabled` boolean: Whether translators can edit content on this step.
          - `offlineTranslationEnabled` boolean: Whether content on this step can be translated offline.
          - `mtPrepopulation` boolean, nullable: Whether machine translation pre-populates this step's content.
          - `tmPrepopulation` boolean, nullable: Whether Translation Memory pre-populates this step's content.
          - `prepopulationThreshold` integer, nullable: Minimum match score for TM/MT pre-population.
          - `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.
          - `localePairs` LocalePairGroup[], nullable: Locale coverage of this step, if it differs from the workflow's own coverage. `null` when not scoped to a single project.
            - `sourceLocaleId` 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.
            - `targetLocaleIds` LocaleId[], required
          - `actions` WorkflowAction[]
            - `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/workflows/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)