---
title: "POST /api/team/users/role"
method: POST
path: "/api/team/users/role"
tags: ["Team"]
---

# POST /api/team/users/role

`POST /api/team/users/role`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/team/users/role`
- Auth: HTTP bearer

Requirements:<br/>- auth-client scopes: "team"<br/>- user role: "admin"

## Request body

- ChangeUserRoleRequest
  - `role` 'admin' | 'contributor' | 'editor', required
  - `userId` string, uuid, required

## Response `200`

## Other responses

- `401`: If missing authentication token.
- `403`: If user does not match the required role, or authenticated client does not have the required access scopes.

---

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