---
title: "List unsent drafts on an inbox"
method: GET
path: "/api/inboxes/{channelId}/drafts"
tags: ["Inboxes"]
---

# List unsent drafts on an inbox

`GET /api/inboxes/{channelId}/drafts`

## Request

- Base URL: `https://core-api.getaptly.com`
- URL: `https://core-api.getaptly.com/api/inboxes/{channelId}/drafts`
- Auth: one of:
  - API key in header `x-token`
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/getaptly/apis/aptly-api/docs/api/inboxes/:channelId/drafts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the unsent drafts on the given email inbox. The inbox is identified
by its `channelId` — the same value returned as `channelId` from
`GET /api/users/{userId}/inboxes`.

Each item in the response is a draft entry with the parent discussion's
`streamId` attached. Drafts currently in the process of sending (after
`POST /api/email/send` was called and before the upstream provider accepts
the message) are excluded.

With API-key auth the only scope check is that the inbox belongs to your
company. With delegate-token auth (`inboxes:*` scope) the inbox must also be
one the authenticated user can reach personally or via a team membership.

## Path parameters

- `channelId` string, required

## Response `200`

List of unsent drafts on the inbox.

- object
  - `data` object[]
    - `streamId` string: ID of the discussion the draft belongs to.
    - `uuid` string: Draft entry UUID — pass as `uuid` to `POST /api/email/send`.
    - `channelId` string: External channel meta ID this draft will be sent from.
    - `subject` string, nullable
    - `content` string, nullable: HTML body of the draft (Email type).
    - `to` object[]
      - `value` string
      - `label` string, nullable
    - `cc` object[]
    - `bcc` object[]
    - `attachments` object[]
    - `ownerId` string, nullable
    - `sentBy` string, nullable
    - `addedToOutboxAt` string, date-time, nullable

## Other responses

- `401`: Invalid or missing API key, or inbox not accessible.
- `404`: Inbox not found.

---

[API](https://skmtc.dev/getaptly/apis/aptly-api.md) - [All operations](https://skmtc.dev/getaptly/apis/aptly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaptly/apis/aptly-api/revisions/75c367e0b8e5?raw)