> 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_snapshot`

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `known_revision` | string | no | Opaque revision received earlier, optional. |

## Call it

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