---
title: "Update team user"
method: PATCH
path: "/v1/account/users/{user_id}"
tags: ["Team Users"]
---

# Update team user

`PATCH /v1/account/users/{user_id}`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/account/users/{user_id}`
- Auth: HTTP bearer

Updates a team user's details including email, password, name, and role.

Cannot modify the account owner (superadmin).

## Path parameters

- `user_id` string, required

## Request body

- object
  - `email` string, email: New email address
  - `password` string: New password
  - `first_name` string: First name
  - `last_name` string: Last name
  - `role` 'admin' | 'member': User role (admin or member)

## Response `200`

User updated successfully

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `success` boolean
    - `id` string
    - `email` string
    - `display_name` string
    - `first_name` string
    - `last_name` string
    - `role` string
    - `is_admin` boolean
    - `is_superadmin` boolean
    - `message` string

## Other responses

- `400`: Invalid request
- `401`: Authentication required or token invalid
- `403`: User does not belong to this account or is account owner
- `404`: Resource not found

---

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