get_settings · Documentation Subagent

Lit les réglages de l’espace : nom, créneau d’envoi jour par jour, jours sans envoi, étalement, règle des doublons, validation humaine obligatoire ou non, adresse postale en pied des messages, webhook.

En bref

Propriété	Valeur
Titre	Réglages de l’espace
Outil MCP	`get_settings`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/get_settings`
Accès	toute clé
État de l’espace	vérifié ou non
Effet	lecture seule
Vue dans l’assistant	non

Ce que fait l’outil

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

Lit les réglages de l’espace : nom, créneau d’envoi jour par jour, jours sans envoi, étalement, règle des doublons, validation humaine obligatoire ou non, adresse postale en pied des messages, webhook. L’humain de l’espace les change avec update_settings.

Paramètres

get_settings ne prend aucun paramètre.

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
`changed`	liste	Après `update_settings` : les réglages modifiés.
`dedup_days`	entier	Jours pendant lesquels une boîte n’écrit pas deux premiers messages au même destinataire.
`limits`	objet	Ce que le service fixe : `daily_max` (quota d’une boîte par jour) et `warmup_steps` (paliers de la montée progressive).
`postal_address`	texte	Adresse postale écrite en pied des premiers messages.
`require_approval`	booléen	Tout envoi de l’espace attend une validation humaine.
`send_window`	objet	Le créneau d’envoi : text (en clair), weekdays (plages du lundi au vendredi si elles sont les mêmes, sinon `null`), saturday, sunday, days (les sept jours, lundi d’abord), `skip_holidays`, `no_send_days`.
`space`	objet	id, name, verified.
`spacing_minutes`	entier	Minutes au moins entre deux envois d’une boîte.
`webhook`	objet ou `null`	Le webhook de l’espace : url (entière pour l’humain, son hôte seul pour un agent) et `set_at`. `null` : aucun.

Exemple d’appel

Les valeurs sont fictives.

HTTP

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

MCP · tools/call

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

Refus possibles

Aucun refus propre à cet outil. Restent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`get_settings`