---
title: "List uploaded assets"
method: GET
path: "/api/assets/list"
tags: ["Assets - Admin"]
---

# List uploaded assets

`GET /api/assets/list`

List files and subfolders under a given S3 prefix (STAGING).

## Query parameters

- `prefix` string — Folder prefix to list

## Headers

- `x-website-token` string, nullable
- `x-api-token` string, nullable

## Response `200`

Successful Response

- AssetListResponse — Response shape for /assets/list. ⚠️ This used to be `Dict[str, List[str]]`, which made the response model itself the reason no non-list field could ever be added — returning `truncated: bool` under that model fails response validation and 500s the endpoint for every consumer. Add new fields HERE, not to a bare dict.
  - `folders` string[], required
  - `files` string[], required
  - `truncated` boolean

## Other responses

- `422` — Validation Error

---

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