List drafts

GEThttps://anjal.app/v1/inboxes/{id}/drafts

scheduled=true lists only drafts waiting to be sent, soonest first. A failed scheduled send shows sendError.

Path parameters

id

required

string

Inbox UUID

Query parameters

`limit` integer
`offset` integer
`scheduled` boolean

Responses

200application/jsonOK

`drafts` object[]
`id` string	format: uuid
`inboxId` string	format: uuid
`to` string[]
`cc` string[]
`bcc` string[]
`subject` string
`plainBody` string
`htmlBody` string
`replyToMessageId` string	format: uuid
`labels` string[]	Applied to the message when the draft is sent.
`sendAt` string	When Anjal will send this draft. Null if not scheduled. format: date-time
`sendError` string	Why the last scheduled send failed. The draft is kept and `sendAt` is cleared.
`createdAt` string	format: date-time
`updatedAt` string	format: date-time

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { Anjal } from "anjal";

const client = new Anjal({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/inboxes/{id}/drafts
const result = await client.request("get", "/v1/inboxes/{id}/drafts", { params: { id: "00000000-0000-0000-0000-000000000000" } });

Example response · 200

{
  "drafts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "inboxId": "00000000-0000-0000-0000-000000000000",
      "to": [
        "agent@example.com"
      ],
      "cc": [
        "agent@example.com"
      ],
      "bcc": [
        "agent@example.com"
      ],
      "subject": "string",
      "plainBody": "string",
      "htmlBody": "string",
      "replyToMessageId": "00000000-0000-0000-0000-000000000000",
      "labels": [
        "string"
      ],
      "sendAt": "2026-11-03T09:51:52.182Z",
      "sendError": "string",
      "createdAt": "2026-11-03T09:51:52.182Z",
      "updatedAt": "2026-11-03T09:51:52.182Z"
    }
  ]
}