List drafts
GET
/draftsLists the drafts the key’s owner has started, newest first.
Needs the permissiondrafts:list
A draft belongs to the person writing it, not to the mailbox, so a colleague’s half-written mail isn’t listed, even in a shared mailbox.
Returns
A list of drafts, each with:
idstring- The draft.
threadIdstring- The conversation it’s in.
mailboxIdstring- The mailbox it will go from.
subjectstring- Its subject.
tolist of strings- Its recipients.
updatedAtstring- When it last changed.
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
drafts:list. TheX-Required-Scopeheader names what’s missing. 429rate_limited- More than 120 requests a minute from this key. Wait for
Retry-Afterseconds.