---
title: "Return a Draft"
method: GET
path: "/v3/grants/{grant_id}/drafts/{draft_id}"
tags: ["Drafts"]
---

# Return a Draft

`GET /v3/grants/{grant_id}/drafts/{draft_id}`

Return a draft by ID.

## Query parameters

- `select` string
- `query_imap` boolean

## Response `200`

Draft

- object
  - `request_id` string — The request ID.
  - `data` object — A draft of a message. You can edit a draft until you send it as a message.
    - `bcc` MessageParticipant[] — The name/email address pairs of the recipients to be BCC'd.
      - `name` string
      - `email` string, email, required
    - `body` string — The body of the draft as either plain-text or HTML content. If the draft has both plain-text and HTML, Nylas returns the HTML version.
    - `cc` MessageParticipant[] — The name/email address pairs of the recipients to be CC'd.
      - `name` string
      - `email` string, email, required
    - `attachments` Attachment[] — An array of Attachment objects. For Google, linked Google Drive files are not included. For Microsoft, linked One Drive files are not included.
      - `id` string, required — The ID of the attachment.
      - `content_type` string — The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types) of the attachment, used by the email client to determine how to display the attachment. If you don't provide a type, Nylas infers it from the file name. The value of this field is exactly the same as the email attachment's `Content-Type` header. The provider might set additional parameters, such as `name` and `charset`. Nylas returns an empty `content_type` field if an attachment file name contains non-ASCII characters (for example, accented characters like `ü`). This is because Google can't detect its content type.
      - `filename` string — The file name of the attachment.
      - `grant_id` string — The ID of grant for the connected user.
      - `content_id` string — (Inline attachments only) The alphanumeric `cid` from the `<img>` tag in the message's HTML. For example, you might see something like `<img src=\"cid:ce9b9547-9eeb-43b2-ac4e-58768bdf04e4\">` in the message body. Sometimes, the `content_id` value is contained in angle brackets (for example, `<ce9b9547-9eeb-43b2-ac4e-58768bdf04e4>`).
      - `content_disposition` string — (Not supported for Microsoft and EWS) The content disposition of the attachment. Usually, this is `inline` or `attachment` followed by the file name (for example, `inline; filename="some-image.jpeg"`).
      - `is_inline` boolean — If `true`, indicates that the attachment is an inline file.
      - `size` integer — The size of the attachment, in bytes.
    - `folders` string[] — A list of folder IDs. For Microsoft, only a single folder is supported. For Google, multiple folders may exist.
    - `from` MessageParticipantResponse[] — An array containing a single name/email address pair, to set as the `From` header.
      - `name` string
      - `email` string, email
    - `grant_id` string — The ID of grant for the connected user.
    - `id` string — A globally unique object identifier for Microsoft accounts. An email address for Google accounts.
    - `metadata` Metadata — The metadata associated with the object. For more information, see [Metadata](/docs/reference/api/#metadata).
    - `object` string — The object type of the response. In this case, `draft`.
    - `reply_to` MessageParticipant[] — An array of name/email address pairs that should receive replies to the message.
      - `name` string
      - `email` string, email, required
    - `snippet` string — A short snippet of the message body (the first 100 characters, with any HTML tags removed). This is useful for displaying a preview of a draft message.
    - `starred` boolean — When `true`, shows that the Draft has been starred by the user. For EWS, this is only supported for Microsoft Exchange 2010 or later.
    - `subject` string — The subject line of the draft.
    - `thread_id` string — A reference to the parent Thread object. If this is a new draft, the thread is empty.
    - `to` MessageParticipant[] — The name/email address pairs of the recipients.
      - `name` string
      - `email` string, email, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit
- `504` — Provider Failure

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)