Skip to main content
POST
Archive, unarchive, mark read or unread, star or change Gmail message labels

Authorizations

Authorization
string
header
required

Session token passed as Authorization: Bearer <session-token> for user-authenticated Den routes.

Path Parameters

messageId
string
required
Required string length: 1 - 512

Body

application/json
addLabelIds
string[]

Add INBOX to unarchive, UNREAD to mark unread, STARRED to star, or user label IDs. Use the dedicated trash action for TRASH.

Maximum array length: 100
Required string length: 1 - 512
removeLabelIds
string[]

Remove INBOX to archive, UNREAD to mark read, STARRED to unstar, or user label IDs. Use the dedicated untrash action for TRASH.

Maximum array length: 100
Required string length: 1 - 512

Response

Google's validated response.

id
string
required
Minimum string length: 1
threadId
string
required
Minimum string length: 1
{key}
any