Retention des donnees

La retention combine une grille commerciale canonique et un reglage technique distinct. Il faut distinguer :

• la retention canonique des plans workspace
• la fenetre de lecture API self-serve derivee de cette meme grille sur /v1/*
• le reglage technique de retention par site dans Settings > Sites > Collecte

Retention publique workspace

Plan	Rétention publique cible
Gratuit	60 jours
Starter	13 mois
Pro	24 mois
Enterprise	Sur mesure

Retention API self-serve

Plan	Rétention de lecture API (dérivée)
Gratuit	Non inclus
Starter	395 jours
Pro	730 jours

Free n’inclut pas d’acces API self-serve. Starter et Pro exposent ci-dessus l’equivalent en jours utilise sur la surface /v1/* effectivement disponible.

Au lancement, ces fenetres API sont derivees de la meme grille canonique de retention que le plan actif. Elles ne constituent pas une seconde table commerciale. Elles restent distinctes seulement du reglage technique de retention par site et du plafond de conservation interne des donnees brutes decrit dans la politique de confidentialite publique.

La surface runtime garde la séparation des rétentions explicite :

• GET /v1/me expose la rétention produit/API dans product.product_retention.api_retention_days
• GET /v1/sites expose le réglage technique distinct au niveau site dans product_configuration.technical_retention.site_data_retention_months

Que se passe-t-il en cas de depassement API

Si une requete demande des donnees plus anciennes que la retention de votre plan, l’API retourne :

• HTTP 422
• Code d’erreur RETENTION_EXCEEDED
• error.details.min_allowed_from indique la date la plus ancienne autorisee

{
  "error": {
    "code": "RETENTION_EXCEEDED",
    "message": "Query start is outside plan retention",
    "request_id": "req_...",
    "details": {
      "min_allowed_from": "2025-12-31"
    }
  }
}

Ajustez votre parametre from pour rester dans la fenetre de retention.

Parametres de date legacy

Les routes publiques /v1/* exigent from et to.

Les anciens parametres start / end ne font plus partie de la surface runtime publique. Ils ne subsistent que sur le contrat partage interne /metrics/* du dashboard.