---
title: "List registered media assets"
method: GET
path: "/admin/media-processing/assets"
tags: ["Admin Media Processing"]
---

# List registered media assets

`GET /admin/media-processing/assets`

## Query parameters

- `prefix` 'avatars' | 'chat-images' | 'face_reference' | 'static' | 'live-actions' | 'audio' | 'scene-covers' | 'scene-backgrounds' | 'scene-avatars' | 'motion' | 'shorts'
- `status` 'pending' | 'processing' | 'ready' | 'partial' | 'failed'
- `limit` string
- `offset` string

## Response `200`

- MediaAssetListResponseDto
  - `items` MediaAssetResponseDto[], required
    - `id` string, required
    - `bucket` string, required
    - `sourceKey` string, required
    - `cdnPrefix` string, required
    - `profile` string, required
    - `status` 'pending' | 'processing' | 'ready' | 'partial' | 'failed', required
    - `sourceBytes` number
    - `durationMs` number
    - `width` number
    - `height` number
    - `sourceCodec` string
    - `renditions` MediaRenditionResponseDto[], required
      - `codec` 'av1' | 'hevc', required
      - `status` 'pending' | 'processing' | 'ready' | 'skipped' | 'failed', required
      - `outputKey` string, required
      - `outputBytes` number — Size of the derivative in bytes
      - `presetUsed` string — Preset the encoder actually used
      - `skipReason` 'source-already-in-codec' | 'output-not-smaller'
      - `encodeMs` number
      - `attempts` number, required
      - `error` string
    - `savedBytes` number — Bytes the best available derivative saves against the source, or null while nothing is ready
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time
  - `total` number, required
  - `countsByStatus` object, required — Asset counts per status across the whole filtered set

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)
