list_events · Documentation Subagent

Lit la main courante de l’espace : qui a fait quoi, et quand (votre agent, vous depuis votre assistant, ou le service).

En bref

Propriété	Valeur
Titre	Main courante
Outil MCP	`list_events`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/list_events`
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 :

Lit la main courante de l’espace : qui a fait quoi, et quand (votre agent, vous depuis votre assistant, ou le service). Sans objet, la journée demandée (aujourd’hui par défaut, heure de Paris). Avec un objet (une boîte, un fil, un message, une campagne, une audience, un contact ou un domaine), tout ce qui le touche, du plus récent au plus ancien. Chaque ligne a une phrase en français, son auteur (actor : kind agent, human ou service ; you vrai quand c’est l’accès qui lit) et les objets qu’elle touche. Lecture seule.

Paramètres

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

Paramètre	Type	Obligatoire	Description
`day`	date	non	Un jour de Paris, AAAA-MM-JJ. Absent : aujourd’hui, sauf si un objet est donné (alors tout son historique).
`inbox_id`	identifiant `inb_…`	non	Une boîte (inb_…).
`thread_id`	identifiant `thr_…`	non	Un fil (thr_…).
`message_id`	identifiant `msg_…`	non	Un message (msg_…).
`campaign_id`	identifiant `cmp_…`	non	Une campagne (cmp_…).
`audience_id`	identifiant `aud_…`	non	Une audience (aud_…).
`contact`	texte	non	Une adresse : ses fils, sa fiche, ses blocages. 254 caractères au plus.
`domain`	texte	non	Un domaine : ses vérifications et ses boîtes. 253 caractères au plus.
`cursor`	texte	non	Curseur de la page suivante : la valeur `next_cursor` de l’appel précédent.
`limit`	entier	non	De 1 à 200.

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
`day`	texte ou `null`	Le jour lu (AAAA-MM-JJ), ou `null` pour l’historique d’un objet.
`events`	liste	Du plus récent au plus ancien : id, at, kind, text (phrase nominale en français, sans sujet), actor (kind agent, human ou service ; name ; you), et les objets touchés (`inbox_id`, `thread_id`, `message_id`, `campaign_id`, `audience_id`, contact, domain) quand il y en a.
`next_cursor`	texte ou `null`	Le curseur de la suite (lignes plus anciennes), ou `null`.

Exemple d’appel

Les valeurs sont fictives.

HTTP

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

MCP · tools/call

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

Refus possibles

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

`list_events`