Apply one triage verb to up to a hundred threads of one mailbox at once.

post/v1/mailboxes/{mailboxId}/triage

Request

  • The document declares no server URL.
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token, scopes: email.write)
    • HTTP bearer

Path parameters

mailboxIdstring required

Request body

verb'read' | 'unread' | 'archive' | 'unarchive' | 'trash' | 'untrash' required
threadIdsstring[] required

One to a hundred threads of THIS mailbox: a page of the list is fifty.

Response

The request has succeeded.

missingstring[] required

Ids this mailbox does not hold — skipped, never a failure of the rest. A selection outlives what it names (another reader erased one), and one stale id must not cost the other ninety-nine.

Changes

No recorded changes to this operation across all 1 revision of this API.