Messages

Get an attachment download URL

Returns the attachment's metadata plus a short-lived presigned `download_url` — the client fetches the bytes from that URL. The URL expires (`expires_at`); re-call this endpoint to mint a fresh one. Unknown/cross-tenant ids return an indistinguishable `404`.

GET
/inboxes/{inbox_id}/messages/{message_id}/attachments/{attachment_id}

Returns the attachment's metadata plus a short-lived presigned download_url — the client fetches the bytes from that URL. The URL expires (expires_at); re-call this endpoint to mint a fresh one. Unknown/cross-tenant ids return an indistinguishable 404.

Authorization

x-api-key<token>

The per-tenant API key. Sent as the x-api-key request header. The key is tenant-scoped.

In: header

Path Parameters

inbox_id*string

The inbox's opaque id (e.g. inb_…).

message_id*string

The message id.

attachment_id*string

The attachment id.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/inboxes/string/messages/string/attachments/string"
{  "attachment_id": "string",  "size": 0,  "download_url": "http://example.com",  "expires_at": "2019-08-24T14:15:22Z",  "filename": "string",  "content_type": "string",  "content_disposition": "string",  "content_id": "string"}
{  "name": "string",  "message": "string"}
{  "name": "string",  "message": "string"}
{  "name": "string",  "message": "string"}

Update an inbox PATCH

Partially update an inbox's `display_name` and/or `metadata`. At least one field must be supplied. Metadata merges: supplied keys are set, a key with a `null` value is removed, and `metadata: null` clears all metadata. The `email` address is immutable.

Get a single message GET

Returns the full structured message — parsed sender/recipients, `text`/ `html` bodies, the reply-history-stripped `extracted_*`, `headers`, threading headers, and the attachment list. A `spam`-labeled message requires the key's `label_spam_read` permission. Unknown/cross-tenant inbox or message ids return an indistinguishable `404`.