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

# Update Workflow

`PUT /v1/workflows/{workflow_identifier}`

Update Workflow

## Path parameters

- `workflow_identifier` string, required

## Request body

- WorkflowUpdateRequest
  - `display_name` string, nullable — New display name value
  - `description` string, nullable — New description value
  - `available_in_chat_assistant` boolean, nullable — Whether to make the workflow available in the chat assistant
  - `tags` string[], nullable — New tags. Replaces the existing tag list.

## Response `200`

Successful Response

- WorkflowUpdateResponse
  - `workflow` Workflow, required
    - `id` string, uuid, required — Unique identifier of the workflow
    - `name` string, required — Name of the workflow
    - `display_name` string, required — Display name of the workflow
    - `type` 'code', required
    - `description` string, nullable — Description of the workflow
    - `customer_id` string, uuid, required — Customer ID of the workflow
    - `workspace_id` string, uuid, required — Workspace ID of the workflow
    - `shared_namespace` string, nullable — Reserved namespace for shared workflows (e.g., 'shared:my-shared-workflow')
    - `available_in_chat_assistant` boolean — Whether the workflow is available in chat assistant
    - `is_technical` boolean — Whether the workflow is technical (e.g. SDK-managed)
    - `archived` boolean — Whether the workflow is archived
    - `tags` string[] — Tags for filtering and discovery

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)