---
title: "Update Team Member Role"
method: PATCH
path: "/api/team/{user_id}"
tags: ["Team"]
---

# Update Team Member Role

`PATCH /api/team/{user_id}`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/team/{user_id}`
- Auth: HTTP bearer

Role-only update — the proxy target for the Next.js PATCH
/api/team/members/[id]. Admin-only, last-admin-demote guard, audit log,
and the exact {success, message, member:{id, role}} response shape the FE
contract expects.

## Path parameters

- `user_id` string, uuid, required

## Request body

- TeamMemberRoleUpdate: Body for the role-only PATCH (mirrors the Next.js /api/team/members/[id] PATCH).
  - `role` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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