Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

activity_report

View as .md

Today’s summary and report.

Tells you in one call what is waiting for a human decision (drafts to approve, received messages without a reply, domains to verify, suspended inboxes) and what the inboxes sent and received: today, or over the last seven days with a breakdown by day. Call it when your human asks how their space is doing, or for a report. Sends are the ones today’s quota counts; replies, bounces, unsubscribes and complaints come from the log: nothing is estimated.

Access

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

Parameters

ParameterTypeRequiredDescription
periodone of today, weeknotoday: the current day (Paris time). week: the last seven days, today included.
inbox_idstringnoA single inbox (inb_…). Absent: every inbox of the key.

Call it

Terminal
curl -s https://api.subagent.fr/v1/activity_report \
  -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/activity_report.