GET
outlook_messages_delta.py
import asyncio
from charter.packs import outlook
result = asyncio.run(outlook.messages_delta.ainvoke({"folderId": ...}))
Requires
https://graph.microsoft.com/Mail.Read or https://graph.microsoft.com/Mail.ReadWrite. Pages by cursor: next_link is sent back as next_link.Path parameters
| Field | Type | Description |
|---|---|---|
folderId * | string | The folder ID, or a well-known folder name. Well-known names work regardless of the locale of the user’s mailbox: archive, clutter, conflicts, conversationhistory, deleteditems, drafts, inbox, junkemail, localfailures, msgfolderroot, outbox, recoverableitemsdeletions, scheduled, searchfolders, sentitems, serverfailures, syncissues. |
Query parameters
| Field | Type | Description |
|---|---|---|
changeType | "created" | "updated" | "deleted" | A custom query option to filter the delta response based on the type of change. Supported values are created, updated, or deleted. |
$select | string | Use the selectqueryparametertoreturnasubsetofpropertiesforaresource.Withselect, you can specify a subset or a superset of the default properties. For example, from,subject returns only the from and subject properties. |
$filter | string | The only supported $filter expressions are $filter=receivedDateTime+ge+{value} or $filter=receivedDateTime+gt+{value}. |
$orderby | string | The only supported $orderby expression is $orderby=receivedDateTime+desc. If you don’t include an $orderby expression, the return order is not guaranteed. |
nextLink | string | The next_link or delta_link a previous call returned (Graph’s @odata.nextLink / @odata.deltaLink). A delta_link ends a round and starts the next one, returning only what changed since. Either link carries every parameter of the first request, the folder included, so when it is set the others are ignored. |
Headers
| Field | Type | Description |
|---|---|---|
maxPageSize | integerPrefer: odata.maxpagesize={} | The maximum number of messages in each page of the response, sent as the Prefer: odata.maxpagesize={x} request header. The page size, not a limit: the round still returns every message, a page at a time. ≥ 1 |