REST Resource: users.drafts
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Draft
A draft email in the user's mailbox.
| JSON representation |
{
"id": string,
"message": {
object (Message)
}
} |
| Fields |
id |
string
The immutable ID of the draft.
|
message |
object (Message)
The message content of the draft.
|
Methods |
|
|
Creates a new draft with the DRAFT label. |
|
|
Immediately and permanently deletes the specified draft. |
|
|
Gets the specified draft. |
|
|
Lists the drafts in the user's mailbox. |
|
|
Sends the specified, existing draft to the recipients in the To, Cc, and Bcc headers. |
|
|
Replaces a draft's content. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-24 UTC.
[null,null,["Last updated 2025-03-24 UTC."],[],[],null,["# REST Resource: users.drafts\n\n- [Resource: Draft](#Draft)\n - [JSON representation](#Draft.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Draft\n---------------\n\nA draft email in the user's mailbox.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"message\": { object (/workspace/gmail/api/reference/rest/v1/users.messages#Message) } } ``` |\n\n| Fields ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` The immutable ID of the draft. |\n| `message` | `object (`[Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message)`)` The message content of the draft. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.drafts/create) | Creates a new draft with the `DRAFT` label. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.drafts/delete) | Immediately and permanently deletes the specified draft. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.drafts/get) | Gets the specified draft. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.drafts/list) | Lists the drafts in the user's mailbox. |\n| ### [send](/workspace/gmail/api/reference/rest/v1/users.drafts/send) | Sends the specified, existing draft to the recipients in the `To`, `Cc`, and `Bcc` headers. |\n| ### [update](/workspace/gmail/api/reference/rest/v1/users.drafts/update) | Replaces a draft's content. |"]]
