---
title: "Fetch the media bytes for an integration asset"
method: GET
path: "/integration-assets/{external_ref}"
tags: ["integrations"]
---

# Fetch the media bytes for an integration asset

`GET /integration-assets/{external_ref}`

Redeems the short-lived signed delivery reference returned by an integration asset search and streams the asset's media bytes. The signed reference is the sole authorization for this endpoint; it is rejected once it expires or when the integration it names has changed.

## Path parameters

- `external_ref` string, required

## Response `200`

The asset's media bytes. The Content-Type header carries the asset's media type, and the response is never cacheable by shared caches.

## Other responses

- `404` — The delivery reference is invalid or has expired.
- `409` — The referenced integration changed after the search.
- `503` — Integration delivery is not available.

## Changes

- **2026-09-04** `9e294ff91619` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/integration-assets/:external_ref/get.md)

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/revisions/987f73fc82de?raw)