Inspect a retained thread
GET/api/threads/:id
x-audience: "management"
x-required-scope: "messages:read"
Returns the complete retained thread summary and its message summaries, oldest receipt first with a stable message ID tie-breaker, 25 messages per page. Current retention applies to both counts and members. Unknown, foreign-account, fully expired and zero-day threads return 404. IDs are the threadId values from message and thread summaries. Each message links to existing preview, raw download, attachment and delivery APIs.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 503
Success
Missing, invalid or revoked credentials.
Required scope or account access missing.
Thread not found, outside this account, or without retained messages.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
Request limiting cannot be enforced. Retry later with backoff.
Response Headers
no-store