Benutzer löschen

API-Referenz zum Löschen mehrerer Benutzer aus einer Organisation anhand von Benutzer-IDs

Löscht mehrere Benutzer aus einer Organisation, basierend auf den Benutzer-IDs.

API-Endpunkt

DELETE https://{yourDomain}/identity/api/User

Scopes

Folgende Scopes sind erforderlich:

• PM.User
• PM.User.Write

Anforderungsheader

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Hinweis:

Um das {access_token} zu erhalten, müssen Sie sich mit einer der hier beschriebenen Methoden authentifizieren.

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
partitionGlobalId (erforderlich)	String	Die ID der Organisation, für die Sie die Roboterkonten abrufen möchten.

Anforderungstext

Der Anforderungstext enthält die Liste der benutzerdefinierten Benutzer-IDs, die Sie per Massenlöschung aus der Organisation löschen möchten.

{
  "partitionGlobalId": "string",
  "userIds": [
    "string"
  ]
}

Antworten

204 Erfolg

Die angegebenen Roboterkonten werden aus der Organisation gelöscht.

Beispielanforderung

Angenommen, Sie haben alle Informationen gesammelt, die zum Erstellen des API-Aufrufs erforderlich sind.

• Ihre {baseURL} lautet: https://{yourDomain}/identity
• Ihre {access_token} ist: 1234 (aus Gründen der Länge).
• Die {partitionGlobalId} lautet: 3fa85f64-5717-4562-b3fc-2c963f66afa6
• Die Benutzer, die Sie löschen möchten, haben die folgenden IDs:
  • Dolores Umbridge: dol-2908
  • Quirinus Quirrell: qui-2609

Der Aufruf sollte dem folgenden Beispiel ähneln (cURL):

curl --location --request DELETE 'https://{yourDomain}/identity/api/User' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userIds": [
        "dol-2908", "qui-2609"
    ]
}'