Download a message attachment

Server URLloading...

GET

/api/mailboxes/{id}/attachments/{attachmentId}

Send

Authorization

Path

The bytes of one attachment on a message in this mailbox — the url a message lists. Fetched from the mail server on demand.

The file and its declared Content-Type were chosen by the sender. The response carries X-Content-Type-Options: nosniff and a locked-down Content-Security-Policy, and only raster images that a message embeds inline are served with an inline disposition; everything else is attachment. Treat the content as untrusted.

It takes the same scope as reading the conversation, because it serves only files attached to messages that scope already lets the caller read.

No existing API key can call this. The scope is opt-in only: a key or an OAuth connection holds it only if it was ticked by name when the credential was created or approved — the legacy full-access key and the "Full access" preset do not carry it.

Requires the mailbox-conversations:read scope — Read the conversations in your hosted mailboxes — every message and attachment people have sent you.

Path Parameters

Response Body

curl -X GET "https://example.com/api/mailboxes/497f6eca-6276-4993-bfeb-53cbbbba6f08/attachments/497f6eca-6276-4993-bfeb-53cbbbba6f08"

"string"

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "message": "string",
    "code": "string",
    "details": {
      "errors": [
        null
      ]
    }
  }
}