Delete multiple object records (up to 1000) asynchronously

Use this endpoint to delete multiple object records of the same object-type in one request. The request is accepted and processed asynchronously. You can track the status of the deletion process using the returned processId. API and Schema Limitations: - Each request can contain up to 1000 object record identifiers - If more records must be deleted → send multiple batch requests

Use this endpoint to delete multiple object records of the same object-type in one request. The request is accepted and processed asynchronously. You can track the status of the deletion process using the returned **processId**. **API and Schema Limitations:** - Each request can contain up to **1000** object record identifiers - If more records must be deleted → send multiple batch requests

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Path parameters

object_typestringRequired

Object type for the records to delete

Request

List of object record identifiers to delete

identifiersobjectOptional

One of the below must be provided

Response

Batch request accepted for deletion - process started

processIdlong or null

Identifier for batch process tracking

messagestring or null

1	import requests
2
3	url = "https://api.brevo.com/v3/objects/vehicle/batch/delete"
4
5	payload = { "identifiers": {
6	"ids": [101, 102, 103],
7	"ext_ids": ["ext-001", "ext-002"]
8	} }
9	headers = {
10	"api-key": "<apiKey>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"processId": 21,
3	"message": "Batch object records are being processed for deletion."
4	}

Authentication

Path parameters

Request

Response

Errors