Objektbeziehung löschen

Verwenden Sie diesen Endpunkt, um eine einzelne Objekt-zu-Objekt-Beziehungskante zu löschen.

Wichtig

Data Objects ist allgemein verfügbar, aber Ihr Workspace muss für Accounts bereitgestellt sein, bevor Sie diesen Endpunkt verwenden können. Um die Bereitstellung anzufordern, gehen Sie zu Dateneinstellungen > Accounts und füllen Sie den Fragebogen aus. Weitere Informationen finden Sie unter Accounts aktivieren.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung data_objects.object_relationships.delete.

Rate-Limit

Dieser Endpunkt gehört zum Data-Objects-Schreib-Bucket mit einem Standardlimit von 1.000 Anfragen pro Minute.

Pfadparameter

Die folgende Tabelle listet und beschreibt die Pfadparameter für den Endpunkt /data_objects/objects/{type_name}/{object_id}/object_relationships.

Anfrageparameter

Die folgende Tabelle listet und beschreibt die Parameter des JSON-Anfragebodys für den Endpunkt /data_objects/objects/{type_name}/{object_id}/object_relationships.

Hinweis

Dieser DELETE-Endpunkt erwartet einen JSON-Anfragebody. Überprüfen Sie, ob Ihr HTTP-Client bei DELETE-Aufrufen Anfragebodys mitsendet.

Beispielanfrage

Dieser Abschnitt enthält ein JSON-Beispiel-Payload und eine cURL-Beispielanfrage.

Beispiel-Payload für die Anfrage

1
2
3
4
5

{
  "rel_kind": "subaccount",
  "related_type_name": "account",
  "related_object_id": "acct-456"
}

cURL-Beispielanfrage

Dieses Beispiel entfernt die subaccount-Beziehung zwischen acct-123 und acct-456. Beide Account-Datensätze bleiben erhalten.

1
2
3
4
5
6
7
8

curl --location --request DELETE 'https://rest.iad-01.braze.com/data_objects/objects/account/acct-123/object_relationships' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "rel_kind": "subaccount",
  "related_type_name": "account",
  "related_object_id": "acct-456"
}'

Antwort

Dieser Abschnitt enthält ein Beispiel für eine erfolgreiche Antwort sowie die Antwortfelder.

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 kann den folgenden Antwortbody zurückgeben.

1

{ "deleted": true }

Antwortparameter

Die folgende Tabelle listet und beschreibt die Felder einer erfolgreichen Antwort.

Fehler

Die folgende Tabelle listet häufige Fehler für diesen Endpunkt sowie deren Behebung auf.