Get a one-time URL to upload a file to

POSThttps://anjal.app/v1/inboxes/{id}/attachment-uploads

For attaching a real file without putting its bytes in a request an agent has to write out. Returns an uploadUrl. PUT the raw file to it with no API key, then attach it by passing { "uploadId": "..." } in attachments on a send, reply, reply-all, forward or draft call. One file, up to 10 MB, valid for 60 minutes, and single-use in both directions: it can be uploaded to once and attached once.

Path parameters

id

required

string

Inbox UUID

Request body

Content-Type: application/json

`filename` required string
`contentType` string
`sizeBytes` integer	If known, so an oversized file is refused before upload.

Responses

201application/jsonUpload slot created

`uploadId` string	format: uuid
`uploadUrl` string	format: uri
`expiresAt` string	format: date-time
`maxBytes` integer
`filename` string
`howTo` string

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! });

// POST /v1/inboxes/{id}/attachment-uploads
const result = await client.request("post", "/v1/inboxes/{id}/attachment-uploads", { params: { id: "00000000-0000-0000-0000-000000000000" } }, { body: {
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 0
} });

Example response · 201

{
  "uploadId": "00000000-0000-0000-0000-000000000000",
  "uploadUrl": "https://example.com",
  "expiresAt": "2026-11-03T09:51:52.226Z",
  "maxBytes": 0,
  "filename": "string",
  "howTo": "string"
}