Emails

Mark a conversation read

Mark every email in a conversation as read in one call. Read state lives on the conversation, not the individual email - this is the one call that clears it.

Requires one of the following scopes: emails:write, emails:all, all:all.

post/v1/threads/{id}/read

Request

  • Base URL: https://api.mailbeast.ai
  • URL: https://api.mailbeast.ai/v1/threads/{id}/read
  • Auth: HTTP bearer

Path parameters

idstring required
Example:13a265fd-f0f2-b1d1-d6fc-154e483183e7

Opaque conversation identifier, exactly as returned in threadId. Do not construct or parse it.

Headers

Idempotency-Keystring
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Optional. A unique key you generate (max 255 chars, such as a UUID) that makes this request safe to retry. Retrying with the same key replays the original response instead of repeating the operation. Reusing a key with a different body returns 422.

Response

threadIdstring required
unreadCountnumber required

Emails left unread in the conversation.

Example response

{
  "threadId": "13a265fd-f0f2-b1d1-d6fc-154e483183e7"
}

Changes

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