> Ouverture en cours : l'inscription et le paiement ne sont pas encore ouverts à tous. L'état du jour : https://subagent.fr/docs/etat.md
>
> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# `inbox_status`

> Point de départ : dit sur quel espace travaille cette clé, s’il est vérifié, ses limites sur le domaine commun, ses permissions, le créneau d’envoi, et pour chaque boîte (ou celle demandée) son état, son réchauffage, le quota du jour (envoyés / restants), les messages en file, les brouillons à valider et le prochain départ possible.

## En bref

| Propriété | Valeur |
|---|---|
| Titre | État des boîtes et quotas |
| Outil MCP | `inbox_status`, sur `https://api.subagent.fr/mcp` |
| Appel HTTP | `POST https://api.subagent.fr/v1/inbox_status` |
| Accès | toute clé |
| État de l'espace | vérifié ou non |
| Effet | lecture seule |
| Vue dans l'assistant | oui : voir [Vues](https://subagent.fr/docs/vues.md) |

## Ce que fait l'outil

Le serveur décrit l'outil ainsi à l'agent qui se branche :

> Point de départ : dit sur quel espace travaille cette clé, s’il est vérifié, ses limites sur le domaine commun, ses permissions, le créneau d’envoi, et pour chaque boîte (ou celle demandée) son état, son réchauffage, le quota du jour (envoyés / restants), les messages en file, les brouillons à valider et le prochain départ possible. À appeler avant d’envoyer, et quand un envoi tarde.

## Paramètres

`inbox_status` accepte ces paramètres. Un paramètre inconnu est refusé avec le code `invalid_argument`.

| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| `inbox_id` | identifiant `inb_…` | non | Une boîte précise (inb_…). Absent : toutes les boîtes de la clé. |

## Résultat

L'outil rend un texte lisible en français et un objet structuré (`structuredContent`). En HTTP, la réponse est cet objet.

| Champ | Type | Contenu |
|---|---|---|
| `billing` | objet ou `null` | Où en est le paiement de l’espace : standing (exempt, unpaid, paid), plan, `paid_until`, `subscription_status` (none, pending, active, `past_due`, canceled), `last_payment` (none, pending, paid, failed). `null` : rien à payer sur ce serveur. |
| `human_email` | texte ou `null` | L’adresse de l’humain de l’espace, masquée (m•••@societe.fr). `null` : aucun humain rattaché. |
| `inboxes` | liste | Une liste : des boîtes. Voir [les champs d'une boîte](https://subagent.fr/docs/boites.md#champs). |
| `key` | objet | La clé qui appelle : `name`, `permissions`, `daily_cap` (son plafond de messages par jour, ou `null`). |
| `now` | texte | Instant de cet état (ISO 8601, heure de Paris). |
| `require_approval` | booléen | Tout envoi de l’espace attend une validation humaine. |
| `send_window` | texte | Créneau d’envoi en clair. |
| `tenant` | objet | L'espace de la clé : `id`, `name`, `brand`, et `domains`, les domaines où il peut créer une boîte. |
| `trial` | objet ou `null` | Limites d’essai des boîtes du domaine commun : limit, used, window, `next_limit`, `next_at`. `null` : aucune. |
| `verified` | booléen | L’espace est vérifié : il envoie. Sinon ses boîtes reçoivent seulement (`verify`). |

## Exemple d'appel

Les valeurs sont fictives.

HTTP :

```sh
curl -X POST https://api.subagent.fr/v1/inbox_status \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

MCP (`tools/call`) :

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inbox_status",
    "arguments": {}
  }
}
```

## Refus possibles

| Code | HTTP | Ce qui s'est passé | Que faire |
|---|---|---|---|
| `not_found` | 404 | L'objet n'existe pas pour cette clé. | Vérifier l'identifiant : il vient de `list_inboxes`, `list_threads`, `get_thread` ou `list_drafts`. |

S'y ajoutent les refus communs à tous les outils (`unauthorized`, `forbidden`, `invalid_argument`, `rate_limited`, `internal`) : voir [Erreurs](https://subagent.fr/docs/erreurs.md#acces).

## Voir aussi

- [Boîtes : inbox_status](https://subagent.fr/docs/boites.md#inbox_status)
- [Limites et quotas](https://subagent.fr/docs/limites.md)
- [`list_inboxes`](https://subagent.fr/docs/reference/list_inboxes.md)
- [`billing_status`](https://subagent.fr/docs/reference/billing_status.md)
- [Tous les outils](https://subagent.fr/docs/reference/index.md)