Update a provisioned user

Applies RFC 7644 section 3.5.2 patch operations. What is implemented: replace of active (deactivating or reactivating the account), of userName, and of name.givenName / name.familyName, written either as an operation path or as keys inside a value object; and add, replace or remove of the enterprise costCenter, which reassigns the member’s department. replace, add and remove are the only operation names understood, read without regard to case, so the capitalized Replace that Entra ID writes is accepted; any other name, or a missing or non-string one, is rejected with a 400. An understood operation aimed at anything not listed above is accepted and changes nothing.

PATCH /api/scim/v2/Users/{id}

Update a provisioned user

Python

import requests

url = "https://app.langwatch.ai/api/scim/v2/Users/{id}"

payload = {
    "schemas": ["<string>"],
    "Operations": [
        {
            "path": "<string>",
            "value": "<unknown>"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/scim+json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

200

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "<string>",
  "userName": "<string>",
  "name": {
    "givenName": "<string>",
    "familyName": "<string>"
  },
  "emails": [
    {
      "primary": true,
      "value": "<string>",
      "type": "<string>"
    }
  ],
  "active": true,
  "meta": {
    "resourceType": "User",
    "created": "<string>",
    "lastModified": "<string>"
  },
  "externalId": "<string>"
}

Authorizations

Authorization · string · header · required

SCIM token for one organization's directory connection, created with POST /api/scim-tokens or in Settings > SCIM. It authenticates provisioning calls only, and stops working if the organization's Enterprise plan lapses.

Path Parameters

id · string · required

Minimum string length: 1

Body

application/scim+json

schemas · string[] · required

Operations · object[] · required

Show child attributes

Response

200

application/scim+json

The updated user.

schemas · string[] · required

Allowed value: "urn:ietf:params:scim:schemas:core:2.0:User"

id · string · required

userName · string · required

name · object · required

Show child attributes

emails · object[] · required

Show child attributes

active · boolean · required

meta · object · required

Show child attributes

externalId · string