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

# Modifier une audience

L'opération REST email.audiences.update de Prescriptio sert à remplacer les critères d’une audience de votre organisation.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/email.audiences.update \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"audience_id":"00000000-0000-0000-0000-000000000001","filtre":"Paris","nature":"segment","nom":"Architectes de Paris","source":"base"}'
```

**Corps JSON**

```json
{
  "audience_id": "00000000-0000-0000-0000-000000000001",
  "filtre": "Paris",
  "nature": "segment",
  "nom": "Architectes de Paris",
  "source": "base"
}
```

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

```json
{
  "action": "<audiences | audience_creer | audience_modifier | audience_supprimer>",
  "fields": {
    "audiences": [
      {
        "id": "<texte>",
        "nature": "<liste | segment>",
        "nom": "<texte>",
        "selection": {
          "contacts": [
            null
          ],
          "liste_id": "<texte>",
          "q": "<texte>",
          "rang_max": 0,
          "source": "<texte>"
        }
      }
    ]
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `audience_id` | texte | oui | — |
| `contacts` | liste | — | Identifiants base:<UUID> ou crm:<UUID> déjà détenus par l'organisation. |
| `filtre` | texte | — | destinataires : texte libre sur le nom, la société, la ville ou l'adresse. |
| `liste_id` | texte | — | UUID d'une liste de la base, ou audience:<UUID> pour une audience enregistrée. creer : reprend d'un geste les contacts de cette liste de Ma base (vérifiée avant de créer). |
| `nature` | texte | oui | (valeurs : `liste` · `segment`) |
| `nom` | texte | oui | creer/modifier : nom de la campagne (120 caracteres au plus). |
| `rang_max` | entier | — | destinataires : 1 décideurs seuls, 2 jusqu'a prioritaire, 3 jusqu'a secondaire, 4 tout le monde (défaut). (min 1, max 4) |
| `source` | texte | — | destinataires : ou chercher. crm = le carnet de contacts, base = Ma base (coordonnées REVELEES seulement), tous = les deux. (valeurs : `tous` · `crm` · `base`) |

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/email.audiences.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_audiences`](https://prescriptio.fr/docs/api/campagne_email_audiences) : 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_audiences](https://prescriptio.fr/docs/api/campagne_email_audiences) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations