Download an attachment

GET/api/v1/mailbox/messages/{message_id}/attachments/{index}
Requires amailbox token— it acts as one mailbox holder, not as the organization.

The file itself, not JSON: the body is the attachment's bytes, with its Content-Type and a Content-Disposition carrying the file name. index comes from the message's attachments.

Errors

Status When
401 No token, or the session expired or was signed out. Sign in again with POST /mailbox-auth/login.
403 The account has a temporary password: until POST /security/password succeeds, every other call answers this with error_code: password_change_required.
404 Message not found or Attachment not found.

Parameters

NameInTypeDescription
message_idrequiredpathstring
indexrequiredpathinteger

Request

GET/api/v1/mailbox/messages/{message_id}/attachments/{index}
curl -X GET 'https://courier.mailyte.com/api/v1/mailbox/messages/01JBT8XQ2M9WYC3K4F6R7S8T9V/attachments/01JBT8XQ2M9WYC3K4F6R7S8T9V' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

Response

The file's bytes.

Returned inside the standard envelope.

Errors

StatusWhen
401No token, or the session expired or was signed out. Sign in again with `POST /mailbox-auth/login`.
403The account has a temporary password: until `POST /security/password` succeeds, every other call answers this with `error_code: password_change_required`.
404`Message not found` or `Attachment not found`.
422Validation Error

Every status, with what causes it and what to do, is on the error reference.