Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

list_events

View as .md

Activity log.

Reads the space’s activity log: who did what, and when (your agent, you from your assistant, or the service). Without an object, the requested day (today by default, Paris time). With an object (an inbox, a thread, a message, a campaign, an audience, a contact or a domain), everything that touches it, newest first. Each line has a sentence in French, its author (actor: kind agent, human or service; you is true when it is the reading access) and the objects it touches. Read-only.

Access

  • Key: an Escouade Mail key with read.
  • Space: any space, verified or not.
  • Changes nothing: yes, it only reads.
  • Safe to replay: yes.

Parameters

ParameterTypeRequiredDescription
daystringnoA Paris day, YYYY-MM-DD. Absent: today, unless an object is given (then its whole history).
inbox_idstringnoAn inbox (inb_…).
thread_idstringnoA thread (thr_…).
message_idstringnoA message (msg_…).
campaign_idstringnoA campaign (cmp_…).
audience_idstringnoAn audience (aud_…).
contactstringnoAn address: its threads, its record, its blocks.
domainstringnoA domain: its checks and its inboxes.
cursorstringnoCursor of the next page: the next_cursor value from the previous call.
limitintegernoNumber of lines returned.

Call it

Terminal
curl -s https://api.subagent.fr/v1/list_events \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/list_events.

This page in Markdown: /en/mail/docs/reference/list_events.md All the docs for an agent: /en/mail/docs/llms.txt Legal notice · Terms · Privacy · Service status