---
title: "List saved items"
method: GET
path: "/v1/saved-items"
tags: ["Files"]
---

# List saved items

`GET /v1/saved-items`

Returns active saved items owned by the authenticated account, newest first. Each item includes every saved asset with a durable file_path for reuse in compatible generation APIs and a temporary signed URL for previewing or downloading. Filter by type to find characters, references, voices, moodboards, or brand kits. To fetch the next page, pass the response's next_cursor as cursor.

## Query parameters

- `type` 'character' | 'reference' | 'voice' | 'moodboard' | 'brand_kit'
- `limit` integer
- `cursor` string

## Response `200`

200

- object
  - `items` object[], required
    - `id` string, required — Unique ID of the saved item.
    - `type` 'character' | 'reference' | 'voice' | 'moodboard' | 'brand_kit', required — Saved item type.
    - `name` string, nullable, required — User-provided name of the saved item.
    - `assets` object[], required
      - `file_path` string, required — Durable asset path. Pass it to a compatible API asset field without uploading it again.
      - `media_kind` 'IMAGE' | 'VIDEO' | 'AUDIO', required — Media type of the asset.
      - `is_primary` boolean, required — Whether this asset is the saved item's primary asset.
      - `url` string, uri, required — Signed URL for previewing or downloading the asset. Expires after 24 hours.
      - `url_expires_at` string, date-time, required — When the signed URL expires. The saved asset and file_path do not expire.
  - `next_cursor` string, nullable, required — Cursor for the next page, or null when there are no more saved items.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-09-17** `f63b0aa77b51` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/magichourhq/apis/magic-hour-api/changes/v1/saved-items/get.md)

---

[API](https://skmtc.dev/magichourhq/apis/magic-hour-api.md) · [All operations](https://skmtc.dev/magichourhq/apis/magic-hour-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magichourhq/apis/magic-hour-api/revisions/e1d2c7933d94?raw)