Suppression et DSAR

Le RGPD reconnaît aux personnes concernées un ensemble de droits, dont le droit à l'effacement (article 17) et le droit d'accès (article 15). COFFRIFY expose deux points d'entrée dédiés pour déposer et tracer ces demandes : POST /v1/gdpr/deletion pour une demande de suppression, et POST /v1/gdpr/access pour une demande d'accès. Chaque appel enregistre une demande officielle (DSAR, pour *Data Subject Access Request*), lui attribue une référence de suivi, et l'achemine vers la console RGPD de votre espace de travail où une personne la valide et l'exécute. Ces endpoints ne suppriment ni n'exposent aucune donnée dans l'instant : ils ouvrent un dossier traçable, conforme aux délais légaux.

Portée et authentification

Toutes les requêtes utilisent l'en-tête Authorization: Bearer <clé> et visent l'espace de travail associé à la clé. La demande de suppression et la demande d'accès requièrent la portée gdpr:request. L'export complet requiert quant à lui la portée gdpr:export, considérée comme sensible. Avec une clé restreinte (cof_rk_), pensez à inclure ces portées au moment de la création de la clé.

Déposer une demande de suppression

La suppression est irréversible une fois le délai de réflexion écoulé. Pour cette raison, vous devez passer confirm: true dans le corps de la requête : sans ce champ, l'API renvoie une erreur validation_error. Vous pouvez joindre un champ reason libre (jusqu'à 1000 caractères) qui sera conservé dans la trace d'audit.

import { Coffrify } from '@coffrify/sdk';
 
const coffrify = new Coffrify({ apiKey: process.env.COFFRIFY_API_KEY });
 
const request = await coffrify.gdpr.deletion.create({
  confirm: true,
  reason: 'Demande de la personne concernée, art. 17 RGPD',
});
 
console.log(request.cooling_off_until);

La réponse arrive avec le statut 202 Accepted et décrit la suite de la procédure, notamment la date de fin du délai de réflexion (cooling_off_until) et l'adresse du délégué à la protection des données (dpo_email).

{
  "object": "gdpr_deletion_request",
  "workspace_id": "ws_3a9f...",
  "workspace_name": "Cabinet Durand",
  "requested_at": "2026-06-10T09:14:00.000Z",
  "cooling_off_until": "2026-07-10T09:14:00.000Z",
  "next_steps": [
    "An email will be sent to the workspace owner within 24h",
    "Owner must confirm via the email link",
    "Data is permanently deleted after the 30-day cooling-off period",
    "To cancel : contact legal@coffrify.com before the cooling-off ends"
  ],
  "dpo_email": "legal@coffrify.com"
}

Déposer une demande d'accès

La demande d'accès ne prend aucun corps obligatoire : un simple appel authentifié suffit. Elle crée une demande officielle, lui attribue une référence et fixe une échéance de traitement (due_at) à 30 jours. La copie des données est ensuite fournie par nos équipes. Si vous avez besoin de la copie tout de suite, appelez POST /v1/gdpr/export.

import { Coffrify } from '@coffrify/sdk';
 
const coffrify = new Coffrify({ apiKey: process.env.COFFRIFY_API_KEY });
 
const request = await coffrify.gdpr.access.create();
 
console.log(request.due_at);

{
  "object": "gdpr_access_request",
  "workspace_id": "ws_3a9f...",
  "workspace_name": "Cabinet Durand",
  "requested_at": "2026-06-10T09:14:00.000Z",
  "due_at": "2026-07-10T09:14:00.000Z",
  "next_steps": [
    "Your request has been recorded and assigned a reference",
    "A copy of your personal data will be provided within 30 days",
    "You can also retrieve a structured export immediately via /v1/gdpr/export",
    "Questions : contact legal@coffrify.com"
  ],
  "dpo_email": "legal@coffrify.com"
}

Traiter une DSAR de bout en bout

Lorsqu'une personne exerce ses droits, le cheminement type combine ces endpoints avec la console RGPD de votre tableau de bord. Chaque demande déposée par l'API y apparaît avec sa référence, son type et son échéance, prête à être validée puis exécutée par une personne habilitée.

1. Réception de la demande : la personne concernée vous saisit (par courriel, formulaire ou support).
2. Enregistrement : appelez POST /v1/gdpr/access pour une demande d'accès, ou POST /v1/gdpr/deletion (avec confirm: true) pour un effacement. La demande est tracée et reçoit une référence.
3. Fourniture de la copie (accès) : récupérez immédiatement un export structuré via POST /v1/gdpr/export, puis transmettez-le à la personne dans le délai de 30 jours.
4. Validation humaine (effacement) : le titulaire confirme par le lien reçu par courriel, puis l'effacement est exécuté après le délai de réflexion de 30 jours.
5. Clôture : la demande est marquée comme traitée dans la console RGPD, avec sa trace d'audit.

Gestion des erreurs

Les erreurs suivent le format standard de l'API, avec un objet error portant un code, un message et un request_id à citer en cas de demande d'assistance. L'oubli du champ confirm sur la suppression est l'erreur la plus fréquente.

{
  "error": {
    "code": "validation_error",
    "message": "Pass confirm=true to acknowledge this is irreversible after the 30-day cooling-off",
    "request_id": "req_8f21c0..."
  }
}