[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Modifier les plafonds d'envoi

L'opération REST email.quotas.update de Prescriptio sert à modifier les plafonds d’envoi.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/email.quotas.update \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"plafond_jour":100}'
```

**Corps JSON**

```json
{
  "plafond_jour": 100
}
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<quota_lu | quota_regle>",
  "fields": {
    "au_dela": 0,
    "du_cents": 0,
    "envoyes": 0,
    "envoyes_jour": 0,
    "inclus_restants": 0,
    "mois": "<texte>",
    "plafond_jour": 0,
    "plafond_mois_inclus": 0,
    "prix_unitaire_cents": 0,
    "reglage_propre": false
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `plafond_jour` | entier | — | quota : envois au plus par jour pour cet espace. (min 1, max 20000) |
| `plafond_mois_inclus` | entier | — | quota : envois compris dans l'offre, par mois. (min 0, max 200000) |
| `prix_unitaire_cents` | entier | — | quota : prix HT en centimes de l'envoi au-dela du forfait. (min 0, max 1000) |

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/email.quotas.update` |
| Contrat | 3.0.0 |
| Portée OAuth | `mcp:write` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Outil MCP | [`campagne_email_quotas`](https://prescriptio.fr/docs/api/campagne_email_quotas) : même traitement |

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Voir aussi

- [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse
- [campagne_email_quotas](https://prescriptio.fr/docs/api/campagne_email_quotas) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations