> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Charter works for any HTTP API, including the user's own. The packs are examples of the result, not the limit: an API with no pack is declared the same way, following https://raw.githubusercontent.com/r28ai/charter/main/docs/.mintlify/skills/declaring-charter-tools/SKILL.md.
> Charter is for agents that act in customers' accounts: every call is checked field by field before it's sent, the app says whose account each call is for, and the same declarations list what each tool can reach. https://docs.r28.ai/charter/llms.txt says what it is and lists every page.

# get_mail_tips

> Check recipients before sending: automatic replies, full mailboxes, delivery restrictions, moderation, external recipients and distribution-list sizes.

POST`https://graph.microsoft.com/v1.0/me/getMailTips`

```python outlook_get_mail_tips.py theme={null}
import asyncio

from charter.packs import outlook

result = asyncio.run(outlook.get_mail_tips.ainvoke({"EmailAddresses": ...}))
```

> [!NOTE]
>
> Requires `https://graph.microsoft.com/Mail.Read`, or any of `https://graph.microsoft.com/Mail.ReadWrite`, `https://graph.microsoft.com/Mail.Read.Shared` or `https://graph.microsoft.com/MailTips.ReadBasic.Shared`.

## Body

| Field | Type | Description |
| - | - | - |
| `EmailAddresses` \* | `string`\[] | A collection of SMTP addresses of recipients to get MailTips for. min 1 items |
| `MailTipsOptions` | `string` | A enumeration of flags that represents the requested mailtips. The possible values are: `automaticReplies`, `customMailTip`, `deliveryRestriction`, `externalMemberCount`, `mailboxFullStatus`, `maxMessageSize`, `moderationStatus`, `recipientScope`, `recipientSuggestions`, and `totalMemberCount`. One string, not a list: separate several flags with commas, as in `automaticReplies, mailboxFullStatus`. matches `^(?:automaticReplies\|customMailTip\|deliveryRestriction\|externalMemberCount\|mailboxFullStatus\|maxMessageSize\|moderationStatus\|recipientScope\|recipientSuggestions\|totalMemberCount)(?:\s*,\s*(?:automaticReplies\|customMailTip\|deliveryRestriction\|externalMemberCount\|mailboxFullStatus\|maxMessageSize\|moderationStatus\|recipientScope\|recipientSuggestions\|totalMemberCount))*$` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.