Submit a bulk end-user deletion request

POST

https://example.ada.support/api/v2/end-users/delete

POST

/api/v2/end-users/delete

1 import requests
2 
3 url = "https://example.ada.support/api/v2/end-users/delete"
4 
5 payload = {
6     "identifiers": [
7         {
8             "type": "email",
9             "value": "end-user@example.com"
10         },
11         {
12             "type": "end_user_id",
13             "value": "6463dbcfafb2e65a02fbc5ee"
14         },
15         {
16             "type": "variable_match",
17             "value": "acme-corp",
18             "variable": "company"
19         }
20     ],
21     "client_reference": "ticket-4821"
22 }
23 headers = {"Content-Type": "application/json"}
24 
25 response = requests.post(url, json=payload, headers=headers)
26 
27 print(response.json())

1 {
2   "job_id": "job_01HXW...ZK",
3   "status": "queued",
4   "submitted_count": 3,
5   "created_at": "2026-07-10T14:05:00Z"
6 }

Submits a request to erase all personal data associated with the supplied identifiers. Replace example with your AI Agent’s handle. A successful call returns a 202 with a job_id you can poll for status. Requests are idempotent for 24 hours: an identical resubmission within that window returns the original job instead of creating a new one.

Request

This endpoint expects an object.

identifierslist of objectsRequired

The identifiers to erase. At least one is required, and a single request accepts at most 1000.

client_referencestring or nullOptional

Optional caller-supplied reference echoed back on the job. Two identical requests submitted within 24 hours resolve to the same job.

Response

The deletion request was accepted and a job was created.

job_idstring

Identifier of the created deletion job. Use it to poll job status.

statusenum

Lifecycle state of a deletion job. queued and in_progress are non-terminal; completed, partial, and failed are terminal.

submitted_countinteger

Number of identifiers received in the request.

created_atstringformat: "date-time"

Time the job was created, in ISO 8601 format.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

413

Content Too Large Error

429

Too Many Requests Error

500

Internal Server Error