List object relationship types

Use this endpoint to list relationship kinds available for object-to-object links for a given anchor direction.

important

Data Objects is currently in early access. Your workspace must be enabled before the Data Objects API key permissions appear on Settings > API Keys.

Prerequisites

To use this endpoint, you need an API key with data_objects.read.

Rate limit

This endpoint is in the Data Objects read bucket with a default limit of 50 requests per minute.

Path parameters

The following table lists and describes the path parameters for the /data_objects/types/{type_name}/object_relationship_types endpoint.

Query parameters

The following table lists and describes the query parameters for the /data_objects/types/{type_name}/object_relationship_types endpoint.

Example request

This section includes a sample parameter payload and a sample cURL request.

Sample request payload

Use this JSON object as a reference for request parameters.

1
2
3
4
5
6

{
  "type_name": "account",
  "anchor": "source",
  "limit": 10,
  "offset": 0
}

Sample cURL request

This example lists the object relationship kinds available to the account type when account is the source of the relationship.

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/data_objects/types/account/object_relationship_types?anchor=source&limit=10&offset=0' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Response

This section includes a sample successful response and the response fields.

Example success response

The status code 200 could return the following response body.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "items": [
    {
      "from_type_name": "account",
      "to_type_name": "account",
      "rel_kind": "subaccount",
      "display_name": "subaccount",
      "related_type_name": "account"
    }
  ],
  "total_count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "limit": 10
}

related_type_name is the type on the other side of the relationship for the selected anchor.

Response parameters

The following table lists and describes the fields in a successful response.

Errors

The following table lists common errors for this endpoint and how to resolve them.