---
title: "Update Workflow"
method: PUT
path: "/workflows/{workflowId}"
tags: ["Workflow"]
---

# Update Workflow

`PUT /workflows/{workflowId}`

Updates the workflow in terms of: name, description, task configuration (and its details), and task type configuration values (`configurationValues`). Observe the rules of [JSON Merge Patch Semantics](https://tools.ietf.org/html/rfc7386).

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Request body

- WorkflowUpdateRequest — A model to update a workflow.
  - `name` string — The workflow name.
  - `description` string — The workflow description.
  - `taskConfigurations` WorkflowTaskConfigurationRequest[] — The task configurations.
    - `taskTemplate` ObjectId, required — An object with identifier.
      - `id` string, required
    - `isSkipped` boolean, required
    - `assignees` WorkflowTaskAssigneeRequest[], required — Specifies the list of assignees for the task template. <br> When the 'isSkipped' field is set to 'true', an empty list of assignees should be specified. <br> Total assignee count is limited. See more at [Assigning users and groups to workflow tasks](https://docs.rws.com/791595/743481/trados-enterprise---accelerate/assigning-users-and-groups-to-workflow-tasks) point 5e.
      - `type` 'user' | 'group' | 'vendorOrderTemplate' | 'projectCreator' | 'projectManager', required
      - `user` ObjectIdRequest — An object with identifier.
        - `id` string, required
      - `group` ObjectIdRequest — An object with identifier.
        - `id` string, required
      - `vendorOrderTemplate` ObjectIdRequest — An object with identifier.
        - `id` string, required
    - `scope` TaskConfigurationScopeRequest, required
      - `type` 'global' | 'sourceLanguage' | 'targetLanguage' | 'languageDirection', required — The applicability impact of the workflow configuration: - global: used for global tasks, that are not associated to a target language - sourceLanguage: changes affect only the task associated to the source language specified in `sourceLanguage` field. For using this type, must include the `sourceLanguage` field. - targetLanguage: changes affect only the task associated to the target language specified in `targetLanguage` field. For using this type, must include the `targetLanguage` field. - languageDirection: changes affect only the task associated to the language direction specified in `languageDirection` field. For using this type, must include the `languageDirection` field.
      - `sourceLanguage` SourceLanguageRequest
        - `languageCode` string, required — The language code.
      - `targetLanguage` TargetLanguageRequest
        - `languageCode` string, required — The language code.
      - `languageDirection` LanguageDirectionItem
        - `id` string, required — The language direction identifier.
    - `configurationValues` WorkflowTaskTypeConfigValue[]
      - `id` string, required — The configuration key identifier (e.g. `FORCE_CLOSE_MAX_AGE`, `EDITOR_MODE`, `CONCURRENT_EDITING_ENABLED`).
      - `value` object, required — The configuration value.

## Response `204`

No Content

## Other responses

- `400` — Error codes: * “invalid”: Invalid input in the body parameter mentioned in the “name” field on the error response. * "empty": Empty input in the body parameter mentioned in the "name" field on the error response. * "limit.exceeded": a maximum number of users per task was assigned
- `401` — The user could not be identified.
- `403` — Error codes: * "forbidden": the authenticated user is not allowed to update the Workflow.
- `404` — Error codes: * "notFound": the Workflow could not be found by identifier.
- `409` — Error codes: * "projectPlanChanged": The associated project has already been changed at the level of `projectPlan.taskConfigurations`. Updating the workflow is no longer possible; the project should be updated to set the relevant `projectPlan.taskConfigurations` fields.

---

[API](https://skmtc.net/rws/apis/trados-cloud-platform-api.md) · [All operations](https://skmtc.net/rws/apis/trados-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rws/trados-cloud-platform-api/revisions/d42dac7c28a3/schema)