Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

workspace_events

View as .md

Synchronise the workbench.

Reserved for the view: waits up to 18 seconds for a navigation of this instance. after_sequence is the last command received; ack_sequence the last one applied. Reads and permissions are checked again. Sends nothing.

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.
  • Visibility: called by the app’s views only, never offered to the model.

Parameters

ParameterTypeRequiredDescription
instance_idstringyesInstance of this workbench.
after_sequenceintegeryesSequence number of the last command the view received.
ack_sequenceintegernoSequence number of the last command the view applied.
closebooleannoReleases this instance when the view closes, without waiting.
local_navigationbooleannoSequence barrier after a local navigation gesture. Invalidates earlier commands without reading the page again.

Call it

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

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