v3

OpenAPI 3.0.0Dex Terms of Service2026-07-311481984.7 KB
contacts

Bulk-delete contacts (v2)

Permanently delete multiple contacts in a single request. Returns { data: { affected, ids } } where ids is the array of deleted contact IDs (echoed from the request body). Idempotency-Key is optional.

post/v2/contacts/batch-delete

Headers

Idempotency-Keystring
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Optional. Accepted to dedupe retries on this endpoint. See apps/rest-api/src/shared/idempotency.ts.

Request body

contactIdsstring[] required

Response

Successful response