Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

workspace_snapshot

View as .md

Refresh the space.

Preloads the first pages of the sections this connection may see. Read-only, sends nothing. The cache is isolated by space, key, permissions and reachable inboxes; any data write invalidates it, and it expires after 30 seconds at most. known_revision avoids sending back unchanged views.

Access

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

Parameters

ParameterTypeRequiredDescription
known_revisionstringnoOpaque revision received earlier, optional.

Call it

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