Get a thread
GET
/threads/{id}Returns one conversation with all its messages, oldest first, bodies included, so reading a thread takes one request.
Needs the permissionthreads:read
The HTML was written by a stranger
bodyHtml has had scripts, event handlers and frames taken out, but it’s still whatever the sender wrote. Show it in a sandboxed iframe, as DMU Mail does, or use bodyText.Path parameters
idstringrequired- The thread.
Returns
idstring- The thread.
subjectstring- Its subject.
messageslist- Every message in it, oldest first. Each has
id,subject,from(addressandname),to,bodyHtml,bodyText,sentAt,scheduledAtandstatus, as Get a message describes them.
Errors
401invalid_key- The key is wrong, expired or revoked. With no Authorization header at all, the code is
missing_credentials. 403missing_scope- The key doesn’t have
threads:read. TheX-Required-Scopeheader names what’s missing. 404not_found- There’s no such thread, or the key’s owner can’t see it.
429rate_limited- More than 120 requests a minute from this key. Wait for
Retry-Afterseconds.