---
title: "List saved media"
method: GET
path: "/v1/media"
tags: ["Media"]
---

# List saved media

`GET /v1/media`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/media`
- Auth: HTTP bearer

List your saved images, videos, and audio, including files inside upload folders. Names are ordered consistently; use nextCursor for subsequent pages.

## Query parameters

- `type` 'image' | 'video' | 'audio'
- `limit` integer
- `cursor` string: Opaque nextCursor from the previous page; keep the same filters.

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `media` object[], required
      - `name` string, required
      - `bucket` string, required
      - `mediaUrl` string, uri, required
      - `contentType` string, nullable, required
      - `size` number, nullable, required
      - `createdAt` string, required
    - `nextCursor` string, nullable, required

## Other responses

- `400`: Invalid input.
- `404`: Not found or not owned.
- `409`: Content changed or cannot be edited in its current state.

---

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