---
title: "GET /email/drafts"
method: GET
path: "/email/drafts"
---

# GET /email/drafts

`GET /email/drafts`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/email/drafts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `cursor` string: Opaque cursor from a previous response to fetch the next page
- `limit` integer: Maximum number of items to return per page (1–100, default 20)
- `agentId` string: Filter drafts by agent ID

## Response `200`

OK

- object: Paginated list of email drafts
  - `items` object[], required: Array of email draft resources
    - `id` string, required: Unique identifier of the draft
    - `agentId` string, required: Owning agent ID
    - `orgId` string, required: Owning organization ID
    - `fromIdentityId` string, nullable, required: EmailIdentity used as the sender, or null to use the agent's primary identity at send time
    - `to` string[], required: Recipient email addresses
    - `cc` string[], required: CC recipient email addresses
    - `bcc` string[], required: BCC recipient email addresses
    - `subject` string, nullable, required: Subject line, or null if not yet written
    - `body` string, nullable, required: Plain-text body, or null if not yet written
    - `bodyHtml` string, nullable, required: HTML body, or null if not provided
    - `inReplyTo` string, nullable, required: Optional In-Reply-To Message-ID for threading on send
    - `references` string[], required: Optional References Message-ID chain for threading
    - `metadata` object, nullable, required: Arbitrary metadata
    - `createdAt` string, date-time, required: Timestamp when the draft was created
    - `updatedAt` string, date-time, required: Timestamp when the draft was last updated
  - `pagination` object, required: Pagination metadata
    - `nextCursor` string, nullable, required: Cursor to pass as the `cursor` parameter to retrieve the next page, or null if no more results
    - `hasMore` boolean, required: Whether additional pages of results are available

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)