API referenceMessages
Download a message’s file
GET
A signed download link (valid 5 minutes) for a file on a message — one a customer sent or one you sent. This is the path a webhook’s media[].url carries. A message carries one file today (index 0). 404 when there is none, or when Gauge holds no copy of it (reason attachment_not_available).
ApiKeyheader
AuthorizationBearer <token>An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).
id*stringThe message id.
Format
uuidindex*integerThe attachment’s position on the message (0).
Range
0 <= valueGauge-Version?stringA dated version. Default 2026-10-21.
The file and its signed download link.
application/json- response
messageId*stringFormat
uuidindex*integerRange
0 <= valuecontentType*stringfilename*string|nullsizeBytes*|Range
0 < valuedownload*curl -X GET 'https://app.gauge.chat/api/v2/messages/497f6eca-6276-4993-bfeb-53cbbbba6f08/attachments/0'Example Response
{ "messageId": "8540d774-4863-4d2b-b788-4ecb19412e85", "index": 0, "contentType": "string", "filename": "string", "sizeBytes": 1, "download": { "url": "http://example.com", "expiresAt": "string" }}