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

Delete a team the identity provider keeps, with every grant it held.

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

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

The team's members lose whatever access they had only through it; each removed grant is recorded in the organization's audit log. Only teams the identity provider created can be deleted here.

Parameters

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

Responses

204Group deleted

No body.

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-cc8f",
"schemas": [
"schemas-8ff6"
],
"status": "status-7c31"
}
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-beaa",
"schemas": [
"schemas-5508",
"schemas-c193"
],
"status": "status-fe7d"
}

CLI

gitmoap scim delete-scim-group

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

Used in these guides