One thread, with both sides of the conversation — its most recent messages, and a cursor to the earlier ones. limit defaults to 50.

get/v1/mailboxes/{mailboxId}/threads/{threadId}

Request

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

Path parameters

mailboxIdstring required
threadIdstring required

Query parameters

limitinteger
beforestring

earlierCursor from a previous read of this thread: the messages before those.

Response

The request has succeeded.

idstring required

The STORED thread id — resolved identity, never an echo of the path parameter.

subjectstring required

The starter's subject — the same titling rule the list uses, so a row and its detail never disagree.

earlierCursorstring nullable required

Earlier messages exist: pass this as before to read the page before these. Null when messages reaches the start of the thread.

Changes

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