Skip to content
GitmoapAPIBeta
Identity & platformscim
PATCH/scim/v2/organizations/{group_id}/Groups/{team_id}

Add or remove members, or rename a group.

patch_scim_group
  • Public
    This operation declares no security requirement: it takes no token.
  • Audited · mutation

    x-gitmoap-audit: {"kind":"audited","arg":"mutation"}

Takes add, remove and replace on members — as a list of values or a members[value eq "…"] path — and replace on displayName, up to 100 operations in one request. A remove on members with no value empties the roster. Members added beyond the team's member limit stay on the roster without a place on the team, and a member id that is not a person provisioned for this organization is skipped.

Parameters

Path
  • group_idGroupId (string · uuid)The organization's top-level group
  • team_idTeamId (string · uuid)SCIM group ID — the team's ID

Request body

application/json
  • Operationsarray of ScimPatchOperation
  • schemasarray of stringoptional
Request body exampleSynthesized example
{
"Operations": [
{
"op": "op-7897"
}
]
}

Responses

200The groupapplication/json
  • displayNamestring
  • externalIdstring or nulloptional
  • idstring or nulloptional
  • membersarray of ScimMemberRefoptional
  • metaScimMeta or nulloptional
    • The ScimMeta schema
    • createdstring · date-time
    • lastModifiedstring · date-time
    • locationstring
    • resourceTypestring
  • schemasarray of stringoptional
200 exampleSynthesized example
{
"displayName": "displayName-00ab",
"externalId": "externalId-9c6a",
"id": "id-c88f",
"members": [
{
"value": "value-35d2"
}
],
"meta": {
"created": "2026-10-11T00:07:26Z",
"lastModified": "2026-10-12T23:52:47Z",
"location": "location-ed89",
"resourceType": "resourceType-6ecc"
},
"schemas": [
"schemas-ff6b",
"schemas-97ee"
]
}
400An unsupported operation, or more than 100application/json
Error codes
  • BAD_REQUESTThe request is malformed: a parameter or a body field is not a well-formed value of its type
  • detailstring
  • schemasarray of string
  • statusstringThe HTTP status code, written as text, as the SCIM protocol requires.
  • scimTypestring or nulloptional
400 exampleSynthesized example
{
"detail": "detail-da70",
"schemas": [
"schemas-979f",
"schemas-cb32"
],
"status": "status-dcd5"
}
401No valid SCIM token of this organizationapplication/json
Error codes
  • UNAUTHORIZEDNo credential was sent, or the one sent is invalid, expired or revoked
  • detailstring
  • schemasarray of string
  • statusstringThe HTTP status code, written as text, as the SCIM protocol requires.
  • scimTypestring or nulloptional
401 exampleSynthesized example
{
"detail": "detail-4d61",
"schemas": [
"schemas-15f5",
"schemas-b263"
],
"status": "status-b6be"
}
404Group not foundapplication/json
Error codes
  • NOT_FOUNDThe resource does not exist — or exists and you cannot see it: a private resource you have no access to answers exactly as an absent one does
  • detailstring
  • schemasarray of string
  • statusstringThe HTTP status code, written as text, as the SCIM protocol requires.
  • scimTypestring or nulloptional
404 exampleSynthesized example
{
"detail": "detail-6d9a",
"schemas": [
"schemas-bf0b"
],
"status": "status-c121"
}

CLI

gitmoap scim patch-scim-group

  • --group-ididThe organization's top-level group (id or group path)
  • --team-ididSCIM group ID — the team's ID
  • --Operationsjson
  • --schemasjsonoptional

Used in these guides