Assign emails to a colleague
assign_emailHand messages to a named person on this mailbox, so their assistant sees them as theirs. person is their email address, or their name as the mailbox owner entered it; an ambiguous name or one that matches nobody is refused with the people who could have been meant, so ask the user which and call again. 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. Assigning takes over a message somebody else already holds, and the result says whose claim was replaced. Only the owner and people currently active on the mailbox can be assigned to.
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. | |
| person | Yes | Who to assign to: an email address, or a name. | |
| mailbox | No | IMAP folder the messages are in. Defaults to INBOX. |