Skip to content

Download one attachment​

GET
/v1/aliases/{alias}/messages/{messageId}/attachments/{attachment}

Streams one extracted attachment by its zero-based index (its own content-type + filename).

Authorizations​

apiKey

Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters​

Path Parameters

alias*

The alias id (al_…, URL-safe — preferred) or its full address (percent-encode the @).

Type
string
Required
Example"al_01KXBRV8HB64MA2H6QM49B2V8F"
messageId*

The message's id (evt_…, URL-safe — preferred) or its RFC Message-ID (percent-encoded).

Type
string
Required
Example"evt_01M50GHMJRP15Z4602V9XFVKDA"
attachment*

The attachment's id (att_…, from the message's attachments) or its zero-based index. The response body is the raw bytes; the real filename is on the message JSON — Content-Disposition carries an ASCII fallback plus the exact name as RFC 5987 filename*.

Type
string
Required
Example"att_01M50GHMJRP15Z4602V9XFVKDA_0"

Responses​

The attachment bytes.

application/octet-stream

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Emithook · a Finnoto product