Browse documentation
Applicants

Request Erasure

delete/v1/applicants/{applicant_id}

Schedule data-subject erasure (GDPR art. 17 / CCPA deletion). Admin-only: Bearer keys are full-power within the tenant; operators need ``role=ADMIN``. Refuses with 409 while any flow is still open (PENDING / AWAITING_INPUT / PROCESSING / NEEDS_REVIEW) — reviewers must disposition open cases before the evidence is destroyed. The applicant disappears from list/get immediately (``erased_at``); the arq ``erase_applicant`` job then deletes the S3 documents and the applicant's DB rows. ``audit_log`` rows are deliberately retained (legal-obligation basis, GDPR art. 17(3)(b)) — they carry hashes and ids, not PII, and the job writes a hashes-only ``applicant.erased`` tombstone as the durable record that erasure happened.

Authentication

Send your tenant secret key as a Bearer token. Keep secret keys on your server; never ship them in browser or mobile code.

Parameters

applicant_id
path · required

No additional parameter description.

Example request

cURL
curl --request DELETE \
  --url 'https://api.fideralabs.com/v1/applicants/{applicant_id}' \
  --header 'Authorization: Bearer $FIDERA_API_KEY'

Responses

202Successful Response
application/json
{}
422Validation Error
detail
ValidationError[]

No additional field description.

Operation ID

request_erasure_v1_applicants__applicant_id__delete