Patch a group | Documentation

curl -X PATCH https://api.contentful.com/scim/v2/organizations/org_id/Groups/group_id \
     -H "Content-Type: application/scim+json" \
     -d '{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "replace",
      "path": "displayName",
      "value": "My Group"
    }
  ]
}'

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "id": "<group_id>",
  "meta": {
    "resourceType": "Group",
    "created": "2025-03-14T09:22:18Z",
    "lastModified": "2026-01-07T14:35:42Z",
    "location": "https://api.contentful.com/organizations/7BslKh9TdKGOK41VmLDjFZ/scim/v2/Groups/<group_id>"
  },
  "displayName": "My Group",
  "members": [
    {
      "value": "123",
      "display": "Kasia Kowalska"
    }
  ]
}

Updates team membership via JSON Patch, supporting add, remove, and replace operations on the members attribute. Pass a list of user references (with display and value fields) in the value array.

Path parameters

group_idstringRequired

ID of the Contentful team

org_idstringRequired

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful