> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `workspace_events`

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `instance_id` | string | yes | Instance of this workbench. |
| `after_sequence` | integer | yes | Sequence number of the last command the view received. |
| `ack_sequence` | integer | no | Sequence number of the last command the view applied. |
| `close` | boolean | no | Releases this instance when the view closes, without waiting. |
| `local_navigation` | boolean | no | Sequence barrier after a local navigation gesture. Invalidates earlier commands without reading the page again. |

## Call it

```sh
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](https://escouade.io/mail/docs/reference/workspace_events).