graph_get_mail_delta
Track changes in a mail folder by listing messages added, updated, read, or removed since a previous delta token; seed a token first, then pass it to sync only new changes.
Instructions
List the changes in a mail folder since a previous delta token.
Call it once without delta_link to seed a token, then pass the returned delta_token to receive only what changed since, including read-state changes and removals. Graph tracks one folder at a time and rejects $search on a delta query, so page through the folder you care about.
Args: folder: Mail folder name or ID (default "inbox"). delta_link: Opaque delta token from a previous call. Empty starts a new sync of the folder. top: Maximum number of messages per page (default 50). mailbox: Shared mailbox address or user ID to act on. Empty targets your own mailbox. Requires the delegated Mail.*.Shared permissions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "graph_get_mail_delta"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| folder | No | inbox | |
| mailbox | No | ||
| delta_link | No |