list-shared-mailbox-folder-messages
list-shared-mailbox-folder-messagesRead-onlyIdempotent
Retrieve messages from a specific folder in a shared mailbox. Supports filters, full-text search, time ranges, and pagination for targeted message lookup.
Instructions
List/search messages inside a folder of a shared mailbox.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of explicit time range (ISO date or datetime) | |
| from | No | Start of explicit time range (ISO date or datetime, overrides timeRange) | |
| cursor | No | Continuation token (nextCursor of a previous truncated response). Continues that listing; other query inputs are ignored. | |
| filter | No | OData $filter expression, e.g. "importance eq 'high'" or "hasAttachments eq true" | |
| search | No | Full-text search (KQL supported), e.g. 'from:kiss.peter@ceg.hu subject:"AI projekt" hasattachment:true' | |
| select | No | Comma separated list of properties to return (OData $select) | |
| mailbox | Yes | Shared mailbox address | |
| orderby | No | OData $orderby, e.g. "receivedDateTime desc" | |
| folderId | Yes | Mail folder id | |
| maxItems | No | Maximum items to return across pages (default 50, max 500). Pagination via @odata.nextLink is handled automatically; when the result is truncated, pass its nextCursor as cursor to continue. | |
| timeRange | No | Named time range applied on receivedDateTime |