---
title: "Change a team member's role"
method: PATCH
path: "/v1/team/members/{memberId}/role"
tags: ["Team"]
---

# Change a team member's role

`PATCH /v1/team/members/{memberId}/role`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/team/members/{memberId}/role`
- Auth: API key in header `X-API-Key`

Update the role of an active team member. Cannot change the workspace owner's role.

## Path parameters

- `memberId` string, required

## Request body

- TeamRoleUpdateRequest
  - `role` 'admin' | 'editor' | 'accountant' | 'viewer', required

## Response `200`

Role updated

- object
  - `data` object
    - `id` string
    - `role` string
    - `updatedAt` string, date-time

## Other responses

- `400`: Bad request - invalid parameters or request body
- `401`: Authentication required or invalid API key
- `403`: Cannot change workspace owner role
- `404`: Team member not found
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)