---
title: "Detailed image refs for one message."
method: GET
path: "/v1/messages/{id}/images"
tags: ["Messages"]
---

# Detailed image refs for one message.

`GET /v1/messages/{id}/images`

## Request

- Base URL: `https://api.inboxy.net`
- URL: `https://api.inboxy.net/v1/messages/{id}/images`
- Auth: HTTP bearer

Returns per-image `width`/`height` hints and (for inline cid: images) the matching `attachment_id`. Original third-party URLs never leave the worker — only signed `proxy_url`s.

## Path parameters

- `id` string, uuid, required

## Response `200`

Image refs.

- object
  - `images` ImageRef[]
    - `kind` 'external' | 'inline', required
    - `proxy_url` string, uri, required: Short-lived l.inboxy.net/img/{token} URL. Original third-party URLs never leave the worker.
    - `alt` string, nullable
    - `width` string, nullable
    - `height` string, nullable
    - `attachment_id` string: Inline-only.

## Other responses

- `404`: No matching resource owned by the caller.

---

[API](https://skmtc.dev/inboxy/apis/inboxy-api.md) · [All operations](https://skmtc.dev/inboxy/apis/inboxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inboxy/apis/inboxy-api/revisions/25155a8dec0f?raw)