Base URL
https://app.dmu.email/api/v1
Authentication
Bearer dmk_… API key
Rate limit
120 requests a minute per key

Confirm an upload

PATCH/attachments/{id}

Tells DMU Mail a file has finished uploading. Until then it’s only a reservation, and a draft sent with it fails.

Needs the permissionattachments:confirm

DMU Mail checks with storage rather than taking your word for it, and records the size it finds there. The request needs no body.

Path parameters

idstringrequired
The file, the attachmentId from Upload an attachment.

Returns

idstring
The file.
filenamestring
Its name.
mimeTypestring
Its type, as it was given.
sizenumber
Its size in bytes.
uploadedboolean
False until the upload is confirmed.

Errors

400upload_incomplete
The file isn’t in storage. Upload it, then confirm it.
401invalid_key
The key is wrong, expired or revoked. With no Authorization header at all, the code is missing_credentials.
403missing_scope
The key doesn’t have attachments:confirm. The X-Required-Scope header names what’s missing.
404not_found
There’s no such file, or the key’s owner can’t see it.
429rate_limited
More than 120 requests a minute from this key. Wait for Retry-After seconds.
curl https://app.dmu.email/api/v1/attachments/1f6c8d33 \
  -X PATCH \
  -H "Authorization: Bearer dmk_7f3a9c2e1b4d_Xq8v…"

Response

200 OK

{
  "data": {
    "id": "1f6c8d33",
    "filename": "delivery-note.pdf",
    "mimeType": "application/pdf",
    "size": 84213,
    "uploaded": true
  }
}

Every response wraps its result in data. A page of threads adds nextCursor, which is null on the last page.