---
title: "List assets"
method: GET
path: "/assets"
---

# List assets

`GET /assets`

Returns a paginated list of assets from your library. Includes user-uploaded assets and system assets (e.g. music library).

## Query parameters

- `type` string[]
- `status` 'PROCESSING' | 'READY' | 'FAILED'
- `page` integer
- `pageSize` integer

## Response `200`

An array of assets. Pagination metadata is in response headers.

- Asset[]
  - `id` string, uuid
  - `name` string, nullable
  - `type` 'AUDIO' | 'IMAGE' | 'VIDEO'
  - `status` 'PROCESSING' | 'READY' | 'FAILED' — Processing status. Poll until READY before using as B-roll.
  - `fileUrl` string, nullable — URL to access the asset. Null while processing.
  - `thumbnailUrl` string, nullable — URL to a thumbnail image. Null while processing.
  - `createdAt` string, date-time

## Other responses

- `400` — Unexpected error

## Changes

- **2026-04-16** `3e376c91df56` — 2 breaking, 2 warning, 7 info
  - the response property `items/fileUrl` became nullable for the status `200`
  - the response property `items/name` became nullable for the status `200`
  - added the new `IMAGE` enum value to the `items/type` response property for the response status `200`
  - added the new `VIDEO` enum value to the `items/type` response property for the response status `200`
  - …7 more
- **2026-04-16** `ac2be3dc5af8` — 1 breaking, 9 warning
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `pageSize`
  - deleted the `query` request parameter `status`
  - …6 more
- **2026-04-16** `02d93799e8f1` — 1 breaking, 9 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageSize`
  - added the new optional `query` request parameter `status`
  - …6 more

[Change history](https://skmtc.dev/argildotai/apis/argil-api/changes/assets/get.md)

---

[API](https://skmtc.dev/argildotai/apis/argil-api.md) · [All operations](https://skmtc.dev/argildotai/apis/argil-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/argildotai/argil-api/revisions/f3d0315da0f0/schema)