Claim emails to work on
claim_emailTake a message, or a set of them, so colleagues sharing this mailbox know you are dealing with it and nobody answers it twice. A claim is a marker the mail server keeps on the message, so every colleague's assistant on this mailbox sees it as heldBy in list_emails and search_emails, and reply_email, forward_email, draft_reply and draft_forward warn when the message is held by somebody else. It moves nothing and marks nothing read: the message stays exactly where it is, and a colleague reading the mailbox in Outlook sees nothing different. A message a mail client has moved since it was claimed keeps its marker but not the record of who: it reads as held by "someone", and force: true clears that. A message somebody else already holds is left alone and the result names them; pass force: true to take it over, and the result says whose claim was taken. Claiming a message you already hold changes nothing. Release it with release_email when you are done, or hand it to somebody with assign_email.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uids | Yes | The UIDs to act on, from list_emails or search_emails. Pass every message you want in ONE call: it costs the user one call instead of one per message. Up to 500 at a time. | |
| force | No | Take over a message somebody else holds. Leave it out unless the user has said to: the result names who holds it, and the usual answer is to ask them. | |
| mailbox | No | IMAP folder the messages are in. Defaults to INBOX. |