import { createClient } from "@mailsai/sdk";

const client = createClient(); // reads MAILS_API_KEY

const result = await client.drafts.attachments.list(
  "dft_01JZX8K3M9Q4P7VN2YB6RTDC0E",
);
console.log(result);

from mailsai import create_client

client = create_client()  # reads MAILS_API_KEY

result = client.list_draft_attachments(
    "dft_01JZX8K3M9Q4P7VN2YB6RTDC0E",
)
print(result)

curl 'https://api.mails.ai/v1/drafts/dft_01JZX8K3M9Q4P7VN2YB6RTDC0E/attachments' \
  -H "Authorization: Bearer $MAILS_API_KEY"

{
  "data": [
    {
      "id": "dfa_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "filename": "<filename>",
      "content_type": "<content_type>",
      "size": 0,
      "status": "uploading",
      "chunk_bytes": 0,
      "chunk_count": 0,
      "from_message_id": "<from_message_id>",
      "created_at": "2026-10-04T12:00:00.000Z",
      "storage": { "used_bytes": 0, "limit_bytes": 0 }
    }
  ]
}

200  The draft's files, oldest first.
401  Missing or invalid API key.
403  The API key lacks the required scope
     (insufficient_scope), or the token belongs to an
     app connected by sign-in and this operation is
     closed to connected apps
     (connected_app_not_allowed).
404  Resource not found in this workspace, or the agent
     a send names is archived (agent_archived).
500  Internal server error.

List a draft's files

GET/v1/drafts/{id}/attachmentsscope · read or draft

import { createClient } from "@mailsai/sdk";

const client = createClient(); // reads MAILS_API_KEY

const result = await client.drafts.attachments.list(
  "dft_01JZX8K3M9Q4P7VN2YB6RTDC0E",
);
console.log(result);

from mailsai import create_client

client = create_client()  # reads MAILS_API_KEY

result = client.list_draft_attachments(
    "dft_01JZX8K3M9Q4P7VN2YB6RTDC0E",
)
print(result)

curl 'https://api.mails.ai/v1/drafts/dft_01JZX8K3M9Q4P7VN2YB6RTDC0E/attachments' \
  -H "Authorization: Bearer $MAILS_API_KEY"

{
  "data": [
    {
      "id": "dfa_01JZX8K3M9Q4P7VN2YB6RTDC0E",
      "filename": "<filename>",
      "content_type": "<content_type>",
      "size": 0,
      "status": "uploading",
      "chunk_bytes": 0,
      "chunk_count": 0,
      "from_message_id": "<from_message_id>",
      "created_at": "2026-10-04T12:00:00.000Z",
      "storage": { "used_bytes": 0, "limit_bytes": 0 }
    }
  ]
}

200  The draft's files, oldest first.
401  Missing or invalid API key.
403  The API key lacks the required scope
     (insufficient_scope), or the token belongs to an
     app connected by sign-in and this operation is
     closed to connected apps
     (connected_app_not_allowed).
404  Resource not found in this workspace, or the agent
     a send names is archived (agent_archived).
500  Internal server error.

Path Parameters

idstringrequired

Draft id.

Response

dataobject[]

The files.

Show propertiesHide properties

idstring

File id (dfa_…).

filenamestring

The file's name, as the recipient sees it.

content_typestring

The file's MIME type.

sizeinteger

The file's size in bytes.

statusstring

uploading: some chunks have not arrived, and the draft cannot be sent or scheduled. ready: every chunk is in.

One of: uploading, ready

chunk_bytesinteger

How long each chunk is, except the last, in bytes: 3 MiB.

chunk_countinteger

How many chunks the file is sent in, numbered from 0. 0 on a forward's file, which is read from the email.

from_message_idstring

On a forward's file: the received message it is read from when the draft is sent. Absent on a file that was uploaded.

created_atstring

When the file was added.

storageobject

On the answer to adding a file: how much room the workspace's drafts have left for files. Absent otherwise.

Show propertiesHide properties

used_bytesinteger

What the workspace's drafts hold of files, in bytes, this one included. A forward's own files are read from the email and do not count.

limit_bytesinteger

What the plan lets them hold, in bytes: 200 MB on Free, 2 GB on Pro, 10 GB on Scale.

Was this page helpful?