---
title: "List versioned public media assets"
method: GET
path: "/agent/media"
---

# List versioned public media assets

`GET /agent/media`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agent/media`
- Auth: HTTP bearer

Returns exact positive-projection media fields for server-authorized creator spaces. Arbitrary metadata and authority fields are excluded.

## Query parameters

- `creator_id` string
- `limit` integer

## Response `200`

Versioned public media list

- AgentMediaListOperationResponse
  - `schema` 'bamf.operation-result/v1', required
  - `operation_ref` 'bamf.media.list/v1', required
  - `data` AgentMediaListData, required
    - `items` AgentMediaAsset[], required
      - `id` string, required
      - `creator_id` string, required
      - `visual_type` string, nullable, required
      - `source` string, nullable, required
      - `url` string, nullable, required
      - `folder_id` string, nullable, required
      - `folder` object, nullable, required
        - `id` string, required
        - `name` string, nullable, required
      - `is_favorite` boolean, required
      - `created_at` string, date-time, nullable, required
      - `updated_at` string, date-time, nullable, required
    - `page` AgentReadPage, required
      - `limit` integer, required
      - `returned` integer, required
  - `receipt` unknown, required

## Other responses

- `400`: Invalid query
- `401`: Missing or invalid bearer token
- `403`: Creator or scope access denied
- `500`: Media temporarily unavailable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)