---
title: "Update a team member's role"
method: PUT
path: "/team-members/{team_member_id}/role"
tags: ["Teams"]
---

# Update a team member's role

`PUT /team-members/{team_member_id}/role`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/team-members/{team_member_id}/role`
- Auth: HTTP bearer

Update the role assigned to a specific team member.

:::note
You cannot modify the business owner or assign the owner role to another team member.
:::

For more information, see the guides: [Manage team members](https://developer.revolut.com/docs/guides/manage-accounts/teams/manage-team-members).

## Path parameters

- `team_member_id` string, uuid, required

## Request body

- object
  - `role_id` string, required: The ID of the role to assign to the team member. For default roles (such as `Owner`, `Admin`, `Member`), the ID is the same as the role name. For custom roles, use the UUID returned by the [`GET /roles` operation](#get-roles).

## Response `204`

Role was updated.

## Other responses

- `400`: Bad request Returned when the specified role ID does not exist or does not belong to this business.
- `401`: Unauthorized – authentication credentials are missing or invalid Returned when the request was not fulfilled because authentication has failed or has not been provided.
- `403`: Action forbidden - insufficient permissions to perform this action Returned, for example, when you don't have permissions necessary to perform this action.
- `404`: Not found Returned when the team member that you're trying to update doesn't exist.
- `422`: Cannot modify owner Returned when you're trying to modify the business owner or assign the owner role to another team member.
- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)