save_audience · Documentation Subagent

En bref

Propriété	Valeur
Titre	Enregistrer une audience
Outil MCP	`save_audience`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/save_audience`
Accès	permission `send`
État de l’espace	vérifié : sinon, refus `space_unverified`
Effet	écriture
Vue dans l’assistant	oui : voir Vues

Ce que fait l’outil

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

Crée une audience, ou renomme celle indiquée par audience_id. Les contacts se chargent ensuite avec import_contacts.

Paramètres

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

Paramètre	Type	Obligatoire	Description
`audience_id`	identifiant `aud_…`	non	Audience à renommer, facultative.
`name`	texte	oui	Nom de l’audience. 160 caractères au plus.

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
`audience`	objet	Une audience : id (aud_…), name, source (subagent, ou l’outil d’où elle est reprise), `external_id`, contacts (leur nombre, dans `list_audiences`), `created_at`, `updated_at`.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/save_audience \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Architectes de Lyon"
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_audience",
    "arguments": {
      "name": "Architectes de Lyon"
    }
  }
}

Refus possibles

Code	HTTP	Ce qui s’est passé	Que faire
`audience_scope`	403	Les audiences demandent un accès à toutes les boîtes de l’espace ; cette clé est limitée à certaines.	Passer par une clé qui accède à tout l’espace, ou par l’assistant de l’humain.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`save_audience`