Update a provisioned group

Applies RFC 7644 section 3.5.2 patch operations. What is implemented: add of members, remove of members (named by a value filter on the path, as Entra ID writes it, or in the operation value), replace of displayName, and replace of the whole member list. replace, add and remove are the only operation names understood, read without regard to case, so the capitalized Add / Remove that Entra ID writes are accepted; any other name, or a missing or non-string one, is rejected with a 400. An add or a remove aimed at anything other than members is accepted and changes nothing. A replace that is not a displayName rename is treated as a replacement of the whole member list, so one that carries no members empties the group.

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

Update a provisioned group

Python

import requests

url = "https://app.langwatch.ai/api/scim/v2/Groups/{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:Group"
  ],
  "id": "<string>",
  "displayName": "<string>",
  "meta": {
    "resourceType": "Group",
    "created": "<string>",
    "lastModified": "<string>"
  },
  "externalId": "<string>",
  "members": [
    {
      "value": "<string>",
      "display": "<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 group.

schemas · string[] · required

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

id · string · required

displayName · string · required

meta · object · required

Show child attributes

externalId · string

members · object[]

Show child attributes