Configurer la politique de rétention et déclencher la suppression

L'API Coffrify expose deux endpoints RGPD complémentaires : GET /v1/gdpr/retention retourne la politique de conservation par catégorie de données et par plan (Free, Pro, Ultra, Entreprise) sans nécessiter d'authentification, tandis que POST /v1/gdpr/deletion enregistre une demande d'effacement au sens de l'article 17 du RGPD pour l'ensemble de l'espace de travail. La suppression effective n'est pas immédiate : elle suit un délai de rétractation de 30 jours, après confirmation par e-mail du propriétaire. Toute requête de suppression est tracée dans le journal d'audit et dans la console RGPD/DSAR de l'administration.

Authentification

L'endpoint GET /v1/gdpr/retention est public et ne nécessite aucune clé. Pour POST /v1/gdpr/deletion, vous devez présenter une clé API dont les scopes incluent gdpr:request. Utilisez le header Authorization: Bearer <clé> avec une clé de production (cof_live_…) ou de test (cof_test_…). Les clés sandbox (cof_sandbox_…) sont également acceptées en environnement de développement. Toute tentative avec un scope absent retourne 403 scope_missing.

Corps de la requête (POST /v1/gdpr/deletion)

La demande d'effacement ne requiert que peu de champs ; l'essentiel est la confirmation explicite de l'intention. Le tableau ci-dessous précise ce qui est attendu.

Exemples d'appel

Les exemples ci-dessous montrent les deux appels : lire la politique de rétention (public, sans clé) puis déposer une demande d'effacement (authentifié, scope gdpr:request).

# 1. Consulter la politique de rétention (public)
curl https://api.coffrify.com/api/v1/gdpr/retention
 
# 2. Déclencher une demande d'effacement
curl -X POST https://api.coffrify.com/api/v1/gdpr/deletion \
  -H "Authorization: Bearer cof_live_..." \
  -H "Content-Type: application/json" \
  -d '{"confirm": true, "reason": "Fin de contrat client"}'

Réponse : GET /v1/gdpr/retention

La réponse détaille, par catégorie de données (data_categories), la durée de conservation pour chaque plan. Utilisez-la pour informer vos utilisateurs ou aligner votre propre politique sur celle de Coffrify.

{
  "object": "retention_policy",
  "data_categories": [
    { "category": "transfer_files",     "free": "30 days", "pro": "365 days", "ultra": "7 years", "entreprise": "configurable" },
    { "category": "audit_logs",         "free": "30 days", "pro": "365 days", "ultra": "7 years", "entreprise": "7 years or contract" },
    { "category": "webhook_deliveries", "free": "30 days", "pro": "30 days",  "ultra": "30 days",  "entreprise": "30 days" },
    { "category": "user_sessions",      "free": "90 days", "pro": "90 days",  "ultra": "90 days",  "entreprise": "90 days" },
    { "category": "download_logs",      "free": "30 days", "pro": "365 days", "ultra": "7 years", "entreprise": "7 years or contract" },
    { "category": "newsletter_emails",  "free": "until unsubscribe", "pro": "until unsubscribe", "ultra": "until unsubscribe", "entreprise": "until unsubscribe" },
    { "category": "billing_invoices",   "free": "n/a",     "pro": "10 years (legal)", "ultra": "10 years (legal)", "entreprise": "10 years (legal)" }
  ],
  "after_account_deletion": {
    "operational_data": "purged within 30 days of confirmed deletion",
    "backups": "purged within 90 days",
    "legal_required_data": "kept for the legal minimum (typically 10 years for invoices)"
  },
  "related_tools": [
    "coffrify_request_data_deletion",
    "coffrify_gdpr_export",
    "coffrify_list_consent_log"
  ],
  "notes": "This policy is informational. Exact retention may be overridden by your contract."
}

Réponse : POST /v1/gdpr/deletion (HTTP 202)

Un 202 Accepted confirme l'enregistrement de la demande, pas son exécution immédiate : l'effacement suit le délai légal et opérationnel. Conservez l'identifiant de la demande pour en suivre l'état.

{
  "object": "gdpr_deletion_request",
  "workspace_id": "ws_01hxyz...",
  "workspace_name": "Acme Corp",
  "requested_at": "2026-06-06T14:32:00.000Z",
  "cooling_off_until": "2026-07-06T14:32: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"
}

Erreurs

Les erreurs portent surtout sur l'authentification et le scope gdpr:request, ou sur une demande déjà en cours pour le même workspace. Le tableau ci-dessous indique la résolution.

Voir aussi

• Exporter les données RGPD (Art. 20)
• Consulter le journal d'audit
• Gérer les consentements et les journaux de consentement
• Référence complète : endpoint POST /v1/gdpr/deletion
• Référence complète : endpoint GET /v1/gdpr/retention
• Sécurité et scopes des clés API