API ReferencePrivacy Requests
Create a privacy request
File a privacy request (also called a data subject request) for one or more subjects across the organization: request_type is deletion (irreversible erasure of all events and identity records) or export (a machine-readable DSAR artifact; window applies to exports only). Requires an organization-scoped API token with privacy_requests:write. Deletion is rate limited to 5 requests per minute, export to 30. Returns 202 with the request id to poll.
AuthorizationBearer <token>
Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/privacy-requests" \ -H "Content-Type: application/json" \ -d '{ "request_type": "deletion", "distinct_ids": [ "string" ] }'Empty