GET /v1/console/plans et POST /v1/console/plan : rétention et espace média inclus, facturés au mois en jetons.
GET /v1/storage (voir « Recevoir les messages ») indique votre volume stocké et votre rétention effective ; cette rétention et l'espace média inclus dépendent de votre palier de stockage. Il en existe quatre, du plus petit au plus grand : free, starter, business et scale. Un palier supérieur donne à la fois plus de jours de rétention et un meilleur ratio jeton/Go, et c'est le même prélèvement mensuel qui paie les deux.
Voir la grille de tarifs à jour
Les durées de rétention, l'espace inclus et le prix mensuel de chaque palier sont publiés sur la page Tarifs, qui lit la grille en vigueur. Ils étaient auparavant recopiés ici : deux endroits à mettre à jour, donc l'un des deux finissait périmé.
Le prélèvement est mensuel, automatique, en jetons, depuis votre solde prépayé, exactement comme l'envoi de messages.
GET /v1/console/plans
Retourne les 4 paliers disponibles ainsi que current : votre palier actif, le volume média utilisé (media_bytes), l'espace inclus (included_bytes), used_ratio (0 à 1) et over_cap (true si vous dépassez l'espace inclus).
POST /v1/console/plan
Change de palier immédiatement — body { "code": "starter" }. Ces deux endpoints sont réservés à la console (session du compte, pas la clé sk_live_) : le changement de palier est un choix de facturation, pas un appel d'intégration.
Attention — Au-delà de l'espace inclus : métadonnées seules
Si vous dépassez l'espace inclus par votre palier et ne pouvez pas absorber le dépassement (overage_tokens_per_gb, ou solde insuffisant), les nouveaux médias entrants ne sont plus hébergés — seules leurs métadonnées (media_id, type) sont conservées, comme pour les échos Coexistence. Le texte des messages n'est jamais affecté. Passez à un palier supérieur, ou libérez de l'espace en laissant la purge de rétention faire son travail.