---
title: "Update Workflow Role Assignment"
method: PATCH
path: "/workflows/{id}/roles/{roleName}"
tags: ["Workflows"]
---

# Update Workflow Role Assignment

`PATCH /workflows/{id}/roles/{roleName}`

Updates the assignment of the specified role (e.g. Archiver, Signature Coordinator, etc.) on the workflow to a new user. The new assignee must be eligible to be assigned to the role per the workflow definition configured in workflow designer. Note: If a role is assigned to another role in the workflow configuration, the new assignee will be assigned to both roles. 

**OAuth Scope required:** `public.workflows.updateRoleAssignment`

## Path parameters

- `id` string, required
- `roleName` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- object
  - `userId` string, required — The id of the Ironclad user to assign to the role. Must be eligible to be assigned to the role.

## Response `200`

200

- object
  - `roleName` string, required — The display name of the role that was updated.
  - `assignee` object, required
    - `userId` string, required
    - `displayName` string, required
    - `email` string, required

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404 not found
- `422` — 422

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)