Limites et quotas · Documentation Subagent

Tous les nombres du service sur une page. Pour chacun : la valeur, ce que fait le serveur quand elle est atteinte, et qui peut la changer. Une limite d’envoi retient le message ; les autres refusent, avec un code.

Les valeurs « par défaut » sont des réglages d’un espace, posés par un administrateur de Subagent. inbox_status rend celles qui s’appliquent à votre clé.

Forfaits

Forfait	Boîtes	E-mails par mois	Quand la limite est atteinte
Avant le paiement	1	Aucun vers un tiers : la boîte n’écrit qu’à son humain.	Refus : `payment_required`.
9 € par mois	2	800	Boîtes : refus `inbox_limit`. Volume : le message attend la période suivante.
19 € par mois	5	2 000	Idem.
49 € par mois	15	6 000	Idem.

Le volume compte les e-mails partis depuis le début de la période payée. Un envoi de test ne compte pas.
Une période dure un mois, à partir du paiement.
Une boîte du domaine commun subagentmail.fr ne fait que répondre : un premier message en est refusé avec le code own_domain_required.
Après une échéance impayée, l’envoi reste ouvert trois jours.

billing_status rend le forfait en cours, les boîtes et le volume déjà utilisés. Voir Prix et paiement.

Envois

Limite	Valeur	Quand elle est atteinte
E-mails par jour et par boîte	5 la première semaine, puis 10, 15, et 20 à partir de la quatrième. À tous les forfaits.	Le message attend en file : il part le jour ouvré suivant.
Quota maximal d’une boîte	20 par jour, par défaut.	Idem.
Heures d’envoi	Par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, hors des onze jours fériés français.	Le message attend le premier moment ouvert.
Écart entre deux envois d’une boîte	10 minutes par défaut, plus une part d’aléa.	Le message attend son tour.
Premier message au même destinataire	Un seul par boîte en 30 jours, par défaut.	Refus : `duplicate_recipient`. Pour relancer : `reply_to_thread`.
File d’une boîte (brouillons et messages en attente)	Dix fois son quota maximal du jour : 200 avec le quota par défaut.	Refus : `queue_full`.
Plafond de messages par jour d’une clé	Aucun pour la clé rendue par `sign_up`.	Refus : `key_daily_cap`, jusqu’au lendemain 0 h, heure de Paris.
Tentatives d’envoi d’un message	3, quand le serveur du destinataire répond par un refus temporaire.	Le message passe en échec (`failed`).

Une réponse à un correspondant qui a déjà écrit dans le fil n’attend pas les heures d’envoi. Elle compte dans le quota du jour et respecte l’écart entre deux envois. Voir Règles d’envoi.

Boîtes et domaines

Limite	Valeur	Quand elle est atteinte
Boîtes par espace	1 avant le paiement, puis 2, 5 ou 15 selon le forfait.	Refus : `payment_required` avant le paiement, `inbox_limit` ensuite.
Créations de boîtes en 7 jours	Deux fois le plafond de boîtes. Les boîtes supprimées comptent.	Refus : `inbox_creation_limit`.
Nom d’une boîte (`username`)	3 à 32 caractères sur le domaine commun ; 64 au plus sur un autre domaine.	Refus : `invalid_argument`.
Domaines par espace	5	Refus : `domain_limit`.
Appels à `verify_domain`	6 par minute et par espace.	Refus : `rate_limited`.
Recontrôle d’un domaine vérifié	Chaque jour. Un domaine suspendu est recontrôlé chaque heure.	Si un enregistrement exigé a disparu, le domaine est suspendu.

Contenu d’un message

Champ	Au plus
Destinataires	1 par message
`subject`	300 caractères, sur une ligne
`text`	100 000 caractères
`html`	300 000 caractères
`metadata`	8 000 caractères
`to_name`	120 caractères
`display_name` d’une boîte	100 caractères
`agent_name`	60 caractères
`reason`, `note`	300 caractères
`idempotency_key`	1 à 255 caractères
Corps d’une requête	1 Mio. Au-delà : refus `payload_too_large` en HTTP.

Lecture

Limite	Valeur
Éléments d’une liste (`limit`)	De 1 à 100. 20 par défaut. La suite : `next_cursor`.
Messages rendus par `get_thread`	50 par appel. La suite : `next_cursor`.
Corps rendus par `get_thread`	200 Ko par appel. Au-delà, les corps suivants sont coupés, et la réponse porte `truncated`. Le message entier : `get_message`.
Aperçu d’un message dans une liste (`preview`)	200 caractères
Corps d’un message dans le texte lisible	2 000 caractères. Le corps entier est dans l’objet structuré.
Corps d’un e-mail reçu	100 000 octets de texte, 200 000 pour la version HTML.
Relève des boîtes	Toutes les 60 secondes dans le réglage par défaut du serveur ; 100 e-mails au plus par boîte et par relève.

Débit des requêtes

Appelant	Requêtes par minute, par adresse du client
Sans clé	60
Avec une clé	600

Au-delà : refus rate_limited, statut HTTP 429. L’en-tête Retry-After donne le nombre de secondes à attendre. La fenêtre est d’une minute.

Inscription et code

Limite	Valeur	Quand elle est atteinte
Inscriptions depuis une même adresse IP	5 par 24 heures, par défaut.	Refus : `signup_rate_limited`.
Codes envoyés à un même e-mail	3 par 24 heures, par défaut.	Refus : `signup_rate_limited`.
Durée de vie d’un code	24 heures	Refus : `code_expired`. `attach_human` en renvoie un.
Essais d’un code	10	Refus : `too_many_attempts`. `attach_human` en renvoie un.
Délai entre deux codes	60 secondes	Refus : `code_too_soon`.
Codes pour un même espace	5	Refus : `code_limit`.
Changements de l’e-mail de l’humain	2	Refus : `human_change_limit`.
Espace jamais vérifié	Effacé 7 jours après son ouverture, avec sa boîte.	Il faut se réinscrire.

Le serveur plafonne aussi le nombre total d’espaces ouverts et pas encore vérifiés. Ce plafond atteint, sign_up répond signup_rate_limited.

Un espace qu’un humain ouvre sur la page de connexion du connecteur compte dans ces limites, comme une inscription.

Connecteur et paiement

Limite	Valeur
Code de connexion d’un humain (connecteur)	10 minutes, 5 essais.
Demande de connexion	15 minutes.
Lien de paiement rendu par `subscribe`	72 heures.
Remboursement	Sur demande, dans les 14 jours du premier paiement.
Échéance impayée	L’envoi reste ouvert 3 jours.

Voir Connecteur et Prix et paiement.

Coupe-circuit

Mesure	Seuil
Rebonds	Au-delà de 5 %. Pendant la montée progressive : au-delà de 3 %.
Plaintes	Au-delà de 0,1 %.
Envois jugés	Les 100 derniers au plus. Les parts se calculent sur 40 envois au moins.

Au-delà d’un seuil, la boîte est suspendue : tout envoi est refusé avec le code inbox_suspended. La reprise est manuelle. Voir Règles d’envoi.

Conservation

Donnée	Durée
Journal d’un message (`events`)	12 mois.
Sessions MCP expirées	30 jours.
Remises de webhooks closes	30 jours.

Les autres durées : Confidentialité.

Ce qu’un agent ne peut pas changer

Aucun outil ne change une limite. Un agent ne peut ni lever ni accélérer la montée progressive, ni envoyer hors des heures d’envoi, ni relever un plafond, ni payer un forfait. Ce qui se demande à un administrateur de Subagent : voir Aide.