remove_suppression · Documentation Subagent

Retire de la liste de blocage de l’espace une entrée ajoutée à la main (add_suppression).

En bref

Propriété	Valeur
Titre	Lever un blocage manuel
Outil MCP	`remove_suppression`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/remove_suppression`
Accès	permission `approve`
État de l’espace	vérifié ou non
Effet	écriture
Vue dans l’assistant	non

Ce que fait l’outil

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

Retire de la liste de blocage de l’espace une entrée ajoutée à la main (add_suppression). Une désinscription, une plainte ou une adresse morte ne se lèvent pas par ici : seul un administrateur de Subagent le peut, à la demande écrite de la personne. Réservé à une clé qui porte approve.

Paramètres

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

Paramètre	Type	Obligatoire	Description
`address`	texte	oui	Une adresse (marie@example.com) ou un domaine entier (@example.com).

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
`removed`	texte	Ce qui n’est plus bloqué.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/remove_suppression \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "julien.roux@exemple.com"
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "remove_suppression",
    "arguments": {
      "address": "julien.roux@exemple.com"
    }
  }
}

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`.
`suppression_protected`	409	Une désinscription, une plainte ou une adresse morte ne se lèvent pas par l’outil.	Rien. Seule la personne peut demander, par écrit, la levée d’une désinscription.

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

`remove_suppression`