Excluir relacionamentos de objetos em massa
/data_objects/object_relationships
Use este endpoint para excluir até 50 relacionamentos entre objetos em uma única solicitação.

O Data Objects está disponível para todos, mas seu espaço de trabalho precisa estar provisionado para Accounts antes que você possa usar este endpoint. Para solicitar o provisionamento, acesse Configurações de dados > Accounts e preencha o questionário. Para mais detalhes, consulte Ativar Accounts.
A Braze aceita a solicitação e a processa em segundo plano. Uma resposta 202 significa que o lote está na fila, não que foi aplicado. Para excluir um relacionamento e ver a alteração imediatamente, use Excluir relacionamento de objeto. Para saber quando usar cada um, consulte Endpoints em massa.
Pré-requisitos
Para usar este endpoint, você precisa de uma chave de API com data_objects.object_relationships.bulk_delete. As permissões de registro único, como data_objects.object_relationships.delete, não concedem acesso a este endpoint.
Limite de frequência
Este endpoint está no bucket de gravação em massa do Data Objects, com um limite padrão de 1.000 solicitações por minuto por espaço de trabalho. O limite é compartilhado entre os seis endpoints em massa e com as sincronizações de objetos de dados da Cloud Data Ingestion, e é separado do limite de gravação de registro único.
Parâmetros de solicitação
A tabela a seguir lista e descreve os parâmetros do corpo da solicitação JSON para o endpoint /data_objects/object_relationships.
| Parâmetro | Obrigatório | Tipo de dados | Descrição |
|---|---|---|---|
records |
Obrigatório | Array | Os relacionamentos de objetos a serem excluídos. Deve conter de 1 a 50 registros. A Braze rejeita qualquer outro campo de nível superior. |
records[].type_name |
Obrigatório | String | Tipo do objeto de origem |
records[].object_id |
Obrigatório | String | Identificador do objeto de origem |
records[].rel_kind |
Obrigatório | String | Nome do tipo de relacionamento |
records[].related_type_name |
Obrigatório | String | Tipo do objeto de destino |
records[].related_object_id |
Obrigatório | String | Identificador do objeto de destino |
Como a Braze processa o lote
- A validação é tudo ou nada. Se algum registro falhar na validação, a Braze rejeita a solicitação inteira com
400, não armazena nada e lista todos os erros. Corrija os erros e reenvie a solicitação inteira. - As consultas acontecem durante o processamento. A Braze verifica se os tipos, o tipo de relacionamento e o relacionamento existem quando processa o lote. Então, uma solicitação que retorna
202ainda pode gerar falhas em registros individuais depois. Consulte Falhas de processamento. - Os registros são ordenados pelo horário de recebimento. A Braze marca cada registro com o horário em que recebeu a solicitação, então não envie
updated_at. A Braze rejeita uma solicitação que inclua esse campo. Quando duas solicitações alteram o mesmo relacionamento, prevalece a que a Braze recebeu por último, e a Braze ignora uma gravação mais antiga que chegue depois. - As exclusões podem aguardar. A exclusão de um relacionamento que ainda não existe aguarda em vez de falhar imediatamente. A Braze tenta novamente por cerca de 40 horas (10 tentativas). Se o relacionamento ainda não existir depois disso, o registro falha com
data-object-dependency-not-found.
Exemplo de solicitação
Esta seção inclui um exemplo de carga útil JSON e um exemplo de solicitação cURL.
Exemplo de carga útil da solicitação
{
"records": [
{
"type_name": "contact",
"object_id": "contact-001",
"rel_kind": "works_at",
"related_type_name": "account",
"related_object_id": "acct-001"
}
]
}
Exemplo de solicitação cURL
Este exemplo remove o relacionamento works_at entre contact-001 e acct-001. Os dois objetos continuam existindo.
curl --location --request DELETE 'https://rest.iad-01.braze.com/data_objects/object_relationships' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"records": [
{
"type_name": "contact",
"object_id": "contact-001",
"rel_kind": "works_at",
"related_type_name": "account",
"related_object_id": "acct-001"
}
]
}'
Resposta
Esta seção inclui um exemplo de resposta bem-sucedida e os campos da resposta.
Exemplo de resposta bem-sucedida
O código de status 202 pode retornar o seguinte corpo de resposta.
{
"source_import_id": "api-20261022T153012123456-9f3a1c2b",
"status": "queued",
"record_count": 1
}
Parâmetros de resposta
A tabela a seguir lista e descreve os campos de uma resposta bem-sucedida.
| Parâmetro | Obrigatório | Tipo de dados | Descrição |
|---|---|---|---|
source_import_id |
Obrigatório | String | O identificador que a Braze gerou para esta solicitação. Cada solicitação é uma importação própria. |
status |
Obrigatório | String | Sempre queued. O lote foi aceito e está aguardando processamento. |
record_count |
Obrigatório | Integer | O número de registros na solicitação |
Falhas de processamento
A Braze não retorna esses códigos pelo endpoint. Ela os registra para registros individuais ao processar um lote na fila.
| Código | Significado |
|---|---|
data-object-type-not-found |
type_name ou related_type_name não corresponde a nenhum tipo ativo no espaço de trabalho. |
data-object-relationship-type-not-found |
rel_kind não corresponde a nenhum tipo de relacionamento ativo para esses tipos. |
data-object-ingestion-rejected |
Qualquer outra rejeição. |
data-object-dependency-not-found |
O relacionamento ainda não existia após cerca de 40 horas de novas tentativas. |
Erros
Uma resposta 400 significa que a Braze não armazenou nada. Cada erro tem um id, uma message, o parameter com problema (quando houver) e, para erros no nível do registro, o index do registro (sua posição em records, começando em 0).
A tabela a seguir lista erros comuns deste endpoint e como resolvê-los.
| Status | Causa | Orientação |
|---|---|---|
400 |
Solicitação inválida (invalid-request): o corpo não é um objeto JSON ou é um JSON malformado, records está ausente ou tem menos de 1 ou mais de 50 entradas, ou o corpo contém um campo definido pela Braze (source_type, source_import_id, source_chunk_id ou record_type) |
Envie um objeto JSON cujo único campo seja records, com 1 a 50 registros. |
400 |
Incompatibilidade de esquema (schema-mismatch): um registro não tem um campo obrigatório, tem um campo não reconhecido (incluindo updated_at) ou tem um campo do tipo errado ou com uma string vazia |
Corrija todos os registros listados e reenvie a solicitação inteira. |
401 |
Chave da API REST ausente ou inválida | Verifique se o cabeçalho Authorization usa Bearer YOUR_REST_API_KEY e se a chave está ativa. |
403 |
A chave de API não tem permissão ou a solicitação foi bloqueada pela lista de permissões | Confirme se a chave tem data_objects.object_relationships.bulk_delete e se o seu IP de origem está na lista de permissões da chave, caso esteja configurada. |
404 |
O Data Objects não está ativado para sua empresa | Confirme se o seu espaço de trabalho está provisionado para Accounts. |
429 |
Limite de frequência excedido | Tente novamente após X-RateLimit-Reset e reduza a frequência das solicitações. |
500 |
Não foi possível aceitar o lote (internal-error) |
A Braze não aceitou nada, então é seguro tentar a solicitação novamente. |