---
title: "Update an attribute for a SCIM enterprise user"
method: PATCH
path: "/scim/v2/enterprises/{enterprise}/Users/{scim_user_id}"
tags: ["enterprise-admin"]
---

# Update an attribute for a SCIM enterprise user

`PATCH /scim/v2/enterprises/{enterprise}/Users/{scim_user_id}`

Update a provisioned user's individual attributes.

To modify a user's attributes, you'll need to provide a `Operations` JSON formatted request that includes at least one of the following actions: add, remove, or replace. For specific examples and more information on the SCIM operations format, please refer to the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).

> [!NOTE]
> Complex SCIM `path` selectors that include filters are not supported. For example, a `path` selector defined as `"path": "emails[type eq \"work\"]"` will be ineffective.

> [!WARNING]
> Setting `active: false` will suspend a user. As a result, their handle and primary email address will be obfuscated.
>
> ```
> {
>   "schemas": [
>     "urn:ietf:params:scim:api:messages:2.0:PatchOp"
>   ],
>   "Operations": [
>     {
>       "op": "replace",
>       "value": {
>         "active": false
>       }
>     }
>   ]
> }
> ```

## Path parameters

- `scim_user_id` string, required
- `enterprise` string, required

## Request body

- PatchSchema
  - `Operations` object[], required — patch operations list
    - `op` 'add' | 'replace' | 'remove', required
    - `path` string
    - `value` string — Corresponding 'value' of that field specified by 'path'
  - `schemas` string[], required

## Response `200`

Success, user was updated

## Other responses

- `400` — Bad request
- `401` — Authorization failure
- `403` — Permission denied
- `404` — Resource not found
- `409` — Duplicate record detected
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/github/apis/ghec.md) · [All operations](https://skmtc.net/github/apis/ghec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/ghec/revisions/8ae6d0c8716e/schema)