Upload a file to a one-time URL

PUThttps://anjal.app/uploads/{uploadId}

The receiver for URLs from attachment-uploads. No API key: the t token in the query string is the credential. The body is the raw file bytes. A second upload to the same URL is refused, and so is any wrong or expired token, with the same 404.

Path parameters

uploadId

required

string

Query parameters

t

required

string

Upload token

Request body

Content-Type: application/octet-stream

string

Responses

200application/jsonStored

`uploaded` boolean
`uploadId` string	format: uuid
`filename` string
`sizeBytes` integer

400Already used

404Not valid or expired

413Larger than the slot allows

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

// PUT /uploads/{uploadId}
const result = await client.request("put", "/uploads/{uploadId}", { params: { uploadId: "00000000-0000-0000-0000-000000000000" } }, { body: "string" });

Example response · 200

{
  "uploaded": false,
  "uploadId": "00000000-0000-0000-0000-000000000000",
  "filename": "string",
  "sizeBytes": 0
}