Exercer le droit à l'effacement pour le sujet délégué

Exige une allowlist explicite sur la clé et la capacité rgpd_erasure, avec {"confirm": true}.

Scope requis : users:write. Scopes et délégation.

Délégation utilisateur : exactement un header X-Marko-Delegated-User-Id ou X-Marko-Delegated-User-Email.

Accès complémentaire : allowlist utilisateur explicite sur la clé et capacité rgpd_erasure. Le sujet doit être approuvé et appartenir à la même entité.

Idempotence : header Idempotency-Key obligatoire. Pour reprendre la même mutation, réutiliser la même clé et le même contenu. Écritures et idempotence.

Export, inventaire et effacement RGPD.

Exercer le droit à l'effacement pour le sujet délégué

cURL

curl --request DELETE \
  --url https://partner-api.marko.fr/v1/users/me/rgpd/erasure \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "confirm": true
}
'

200

{
  "privacy_case_id": "11111111-1111-4111-8111-111111111111",
  "status": "intake",
  "result_mode": "metadata_only",
  "reconciliation_required": false,
  "manual_review_required": false,
  "certificate_reference": null,
  "completed_at": null,
  "actions": [
    "delegated_erasure_completed"
  ],
  "replayed": false
}

Authorizations

Authorization · string · header · required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID · string

Partner-generated correlation identifier echoed in logs and error payloads.

Idempotency-Key · string · required

Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write.

Maximum string length: 255

Pattern: ^[!-~]+$

X-Marko-Delegated-User-Id · string

Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation.

X-Marko-Delegated-User-Email · string

Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation.

Body

application/json

confirm · boolean · default: false

Confirmation explicite exigée pour cette action; le scope seul ne remplace pas cette confirmation.

Response

200

application/json

Dossier d'effacement terminé; réponse limitée aux métadonnées.

privacy_case_id · string<uuid> · required

UUID du dossier durable de traitement RGPD.

status · enum<string> · required

État du dossier d'effacement; une réponse accepted n'est pas une confirmation d'effacement terminé.

Available options: intake, verifying, in_progress, waiting_customer, completed, blocked, cancelled

result_mode · string · required

Mode de restitution du résultat d'effacement; la réponse expose les métadonnées du dossier.

Allowed value: "metadata_only"

reconciliation_required · boolean · required

Indique que le résultat doit encore être rapproché de l'état réel du dossier.

manual_review_required · boolean · required

Indique qu'une revue humaine reste nécessaire pour ce dossier ou cette action.

certificate_reference · string | null · required

Référence du certificat d'effacement, si elle existe; null ne constitue pas une preuve d'effacement.

completed_at · string<date-time> | null · required

Date de fin, lorsqu'une exécution ou un traitement est terminé.

actions · enum<string>[] · required

Actions d'effacement enregistrées dans le dossier; leur présence ne signifie pas que toutes sont terminées.

Available options: delegated_erasure_completed, delegated_erasure_blocked, delegated_erasure_reconciliation_pending

replayed · boolean · required

Indique qu'une réponse liée à la même intention a été retrouvée et rejouée.