list_suppressions · Documentation Subagent

Liste les adresses et domaines bloqués pour cet espace (désinscriptions, plaintes, ajouts manuels), les plus récents d’abord.

En bref

Propriété	Valeur
Titre	Liste de blocage
Outil MCP	`list_suppressions`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/list_suppressions`
Accès	permission `read`
État de l’espace	vérifié ou non
Effet	lecture seule
Vue dans l’assistant	oui : voir Vues

Ce que fait l’outil

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

Liste les adresses et domaines bloqués pour cet espace (désinscriptions, plaintes, ajouts manuels), les plus récents d’abord. Avec une adresse complète en query, dit aussi si elle est une adresse morte commune à la plateforme. Pagination par curseur.

Paramètres

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

Paramètre	Type	Obligatoire	Description
`query`	texte	non	Une partie d’adresse ou de domaine ; une adresse complète pour savoir si elle est morte.
`cursor`	texte	non	Curseur de la page suivante : la valeur `next_cursor` de l’appel précédent.
`limit`	entier	non	Nombre d’éléments rendus (20 par défaut). De 1 à 100.

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
`items`	liste	Les entrées de la liste de blocage, les plus récentes d’abord. Chaque élément porte `created_at`, `kind`, `reason`, `scope`, `source`, `value`.
`next_cursor`	texte ou `null`	À repasser en cursor pour la page suivante ; `null` à la dernière page.

Exemple d’appel

Les valeurs sont fictives.

HTTP

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

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_suppressions",
    "arguments": {
      "query": "exemple.com"
    }
  }
}

Refus possibles

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

`list_suppressions`