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

# Update an attribute for a SCIM enterprise user

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

**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.

Update a provisioned user's individual attributes.

To change a user's values, you must provide a specific `Operations` JSON format that contains at least one of the `add`, `remove`, or `replace` operations. For examples and more information on the SCIM operations format, see the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).

**Note:** Complicated SCIM `path` selectors that include filters are not supported. For example, a `path` selector defined as `"path": "emails[type eq \"work\"]"` will not work.

**Warning:** Setting `active: false` will suspend a user and obfuscate the user handle and user email. Since the implementation is a generic SCIM implementation and does not differentiate yet between different IdP providers, for Okta, the user GDPR data will not be purged and the credentials will not be removed.
```
{
  "Operations":[{
    "op":"replace",
    "value":{
      "active":false
    }
  }]
}
```

## Path parameters

- `scim_user_id` 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

## Changes

- **2023-09-19** (3.8) `dc77004dd178` — 1 warning, 1 info
  - added the new `guest_collaborator` enum value to the `allOf[#/components/schemas/user-response]/roles/items/value` response property for the response status `200`
  - removed the `restricted_user` enum value from the `allOf[#/components/schemas/user-response]/roles/items/value` response property for the response status `200`

[Change history](https://skmtc.dev/github/apis/enterprise-server/changes/scim/v2/Users/:scim_user_id/patch.md)

---

[API](https://skmtc.dev/github/apis/enterprise-server.md) · [All operations](https://skmtc.dev/github/apis/enterprise-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/github/enterprise-server/revisions/4ad3e94264bd/schema)