Download a message’s stored media
GET/api/sessions/:sessionId/messages/:chatId/:messageId/media
Download a message’s stored media
Request
Responses
- 200
- 401
- 403
- 404
- 503
The media bytes — the archived file when one exists, else the inline copy stored on the message row (which is how media sent by this account is served) — as an attachment.
The API key is missing, unknown, revoked, or expired
The API key's role, session or chat scope, or IP allow-list does not allow this operation
No stored media for this message — it carries no media, media download was disabled or the payload was over the cap when it was stored (size-only marker), it was a URL-based API send (the gateway stores none of those bytes, though on whatsapp-web.js the own-send echo may), or the message is not in this gateway’s history.
On S3 storage, the gateway already has 50 media downloads open across the status and chat media routes. Retry once the Retry-After header (1 second) has passed.