Emails
List email attachments
List immutable attachment metadata in delivery order for one email.
GET
/api/v1/emails/{messageId}/attachmentsOn this page
Authentication
Send a RouteKite API key as a Bearer token. This endpoint requires the email:read or email:send scope.
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Required | Bearer API key with the required workspace scope.Example: Bearer rk_your_key |
Path parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
messageId | uuid | Required | The RouteKite message identifier.Example: 7dd5da7f-40b0-4c29-bb78-7e0d95ef9eb7 |
Response
| Name | Type | Requirement | Description |
|---|---|---|---|
object | string | Always | Always list. |
data | attachment[] | Always | Attachments in delivery order. |
id | uuid | Always | The attachment identifier. |
object | string | Always | Always attachment. |
position | integer | Always | The one-based attachment delivery order on this email. |
filename | string | Always | The original filename. |
content_type | string | Always | The validated MIME type. |
size_bytes | integer | Always | The validated byte size. |
sha256 | string | Always | The lowercase SHA-256 digest. |
download_available | boolean | Always | Whether RouteKite can currently issue a private download URL. |
created_at | date-time | Always | When the attachment was linked to the email. |
has_more | boolean | Always | Always false for this bounded collection. |
Private metadata
The list never exposes storage paths or download URLs. Retrieve one listed attachment to request a short-lived private download URL.
Errors
| Status | Code | What it means | What to do |
|---|---|---|---|
| 400 | INVALID_REQUEST / INVALID_CURSOR | A filter or pagination cursor is invalid. | Correct the reported query value. |
| 401 | UNAUTHORIZED | The API key is missing, invalid, revoked, or expired. | Check the Bearer header and active key. |
| 403 | FORBIDDEN | The key lacks email:read and email:send access. | Use a key with one of the required scopes. |
| 404 | NOT_FOUND | The email is unavailable in this workspace. | Check the message ID and workspace. |
| 429 | RATE_LIMITED | Too many read requests were sent. | Honor Retry-After before retrying. |
| 500 / 503 | INTERNAL_ERROR / EMAIL_LIST_UNAVAILABLE | RouteKite could not load the requested email data. | Retry after a short delay. |