Roboterkonten löschen

API-Referenz zum Löschen mehrerer Roboterkonten aus einer Organisation

Löscht mehrere Roboterkonten aus einer Organisation, basierend auf der Organisations-ID.

API-Endpunkt

DELETE https://{yourDomain}/identity/api/RobotAccount/{partitionGlobalId}

Scopes

Folgende Scopes sind erforderlich:

• PM.RobotAccount
• PM.RobotAccount.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 Roboterkonten-IDs, die Sie per Massenlöschung aus der Organisation löschen möchten.

{
     "robotAccountIDs": [
          "string",
          "string"
     ]
}

Antworten

200 OK

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 Roboterkonten, die Sie löschen möchten, haben die folgenden IDs:
  • Bot1: 11-xy
  • Bot2: 22-tz

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

curl --location --request DELETE 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
     "robotAccountIDs": [
          "11-xy",
          "22-tz"
     ]
}'