drafts_list - Charter

GET

gmail_drafts_list.py

from charter.packs import gmail

result = await gmail.drafts_list.ainvoke({})

Requires https://www.googleapis.com/auth/gmail.modify. Pages by cursor: nextPageToken is sent back as pageToken. Costs 5 against the provider’s own quota.

Path parameters

Field	Type	Description
`userId`	`string`	The user’s email address. The special value ‘me’ can be used to indicate the authenticated user. defaults to `"me"`

Query parameters

Field	Type	Description
`maxResults`	`integer`	Maximum number of drafts to return. Gmail returns 100 when this is absent. The maximum allowed value for this field is 500. ≥ 1; ≤ 500
`pageToken`	`string`	Page token to retrieve a specific page of results in the list.
`q`	`string`	Only return draft messages matching the specified query. Supports the same query format as the Gmail search box. For example, “from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread”.
`includeSpamTrash`	`boolean`	Include drafts from SPAM and TRASH in the results.