---
title: "Update User"
method: PUT
path: "/scim/v2/Users/{user_id}"
tags: ["scim"]
---

# Update User

`PUT /scim/v2/Users/{user_id}`

Update a user according to SCIM v2 protocol (full replacement)

## Path parameters

- `user_id` string, required

## Query parameters

- `feature` string, nullable

## Request body

- SCIMUserInput
  - `active` boolean
  - `displayName` string, nullable
  - `emails` SCIMUserEmail[], nullable
    - `primary` boolean, nullable
    - `type` string, nullable
    - `value` string, email, required
  - `entitlements` SCIMMultiValuedAttribute[], nullable
    - `display` string, nullable
    - `primary` boolean, nullable
    - `type` string, nullable
    - `value` string, required
  - `externalId` string, nullable
  - `groups` SCIMUserGroup[], nullable
    - `display` string, nullable
    - `type` string, nullable
    - `value` string, required
  - `id` string, nullable
  - `meta` object, nullable
  - `name` SCIMUserName
    - `familyName` string, nullable
    - `formatted` string, nullable
    - `givenName` string, nullable
    - `honorificPrefix` string, nullable
    - `honorificSuffix` string, nullable
    - `middleName` string, nullable
  - `roles` SCIMMultiValuedAttribute[], nullable
    - `display` string, nullable
    - `primary` boolean, nullable
    - `type` string, nullable
    - `value` string, required
  - `schemas` string[], required
  - `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User` SCIMEnterpriseUser
    - `costCenter` string, nullable
    - `department` string, nullable
    - `division` string, nullable
    - `employeeNumber` string, nullable
    - `manager` SCIMUserManager
      - `$ref` string, nullable
      - `displayName` string, nullable
      - `value` string, nullable
    - `organization` string, nullable
  - `userName` string, nullable

## Response `200`

Successful Response

- SCIMUserOutput

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed
- **2026-09-18** `082b5fabd909` — 1 breaking, 9 warning, 7 info
  - removed the required property `schemas` from the response with the `200` status
  - removed the optional property `active` from the response with the `200` status
  - removed the optional property `displayName` from the response with the `200` status
  - removed the optional property `emails` from the response with the `200` status
  - …13 more
- **2026-09-11** `f9848f60f12d` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed
- **2026-09-04** `b260997c7450` — 2 info
  - api tag `✨ SCIM v2 (Enterprise Only)` added
  - api tag `scim` removed
- **2026-08-27** `4a06c3148b6c` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/scim/v2/Users/:user_id/put.md)

---

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