Skip to content
GitmoapAPIBeta
Identity & platformscim
DELETE/scim/v2/organizations/{group_id}/Users/{scim_user_id}

De-provision a person and forget them.

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

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

An active person is de-provisioned first — their access in the organization, their team places, their personal access tokens bound to it and any waiting invite are removed — and the identity provider's record of them is then deleted. Their account and their work are untouched. The organization's last owner cannot be removed.

Parameters

Path
  • group_idGroupId (string · uuid)The organization's top-level group
  • scim_user_idScimUserId (string · uuid)SCIM user ID

Responses

204User de-provisioned and 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-7791",
"schemas": [
"schemas-b2a7",
"schemas-771f"
],
"status": "status-bb32"
}
404User 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-ef36",
"schemas": [
"schemas-af8b"
],
"status": "status-ca0c"
}
409The person is the organization's last ownerapplication/json
Error codes
  • CONFLICTThe request conflicts with the resource's current state; reason says how
  • detailstring
  • schemasarray of string
  • statusstringThe HTTP status code, written as text, as the SCIM protocol requires.
  • scimTypestring or nulloptional
409 exampleSynthesized example
{
"detail": "detail-3bf6",
"schemas": [
"schemas-0d0d",
"schemas-07b2"
],
"status": "status-5d76"
}

CLI

gitmoap scim delete-scim-user

  • --group-ididThe organization's top-level group (id or group path)
  • --scim-user-ididSCIM user ID

Used in these guides