---
title: "List assets"
method: GET
path: "/v1/assets"
tags: ["Assets"]
---

# List assets

`GET /v1/assets`

## Request

- Base URL: `https://nanostudiopro.com/api`
- URL: `https://nanostudiopro.com/api/v1/assets`
- Auth: HTTP bearer

Lists your reusable assets, optionally filtered by `category`. Categories include `model` (faces), `pose` (skeleton/posture references), `background` (scenes), `shoe`, `accessory`, and `upload` (anything else). Use the returned `id` as `reference_asset_id` when generating images.

## Query parameters

- `category` 'model' | 'pose' | 'background' | 'shoe' | 'accessory' | 'upload' | 'product'
- `project_id` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated assets

- object
  - `items` Asset[]
    - `id` string
    - `category` 'model' | 'pose' | 'background' | 'shoe' | 'accessory' | 'upload' | 'product'
    - `name` string
    - `file_path` string: Internal storage key (use `url` for fetching).
    - `url` string, uri: Signed URL tied to a ~6-hour signing window. Use this to display or download the asset; re-fetch the resource for a fresh one.
    - `permanent_url` string, uri: A link that never expires: embed it in a page, an email or another product. Append `&size=xs|thumb|preview|large|original` (default original). Anyone holding it can view this one image; deleting the asset revokes it. See `GET /v1/media/{type}/{id}`.
    - `project_id` string, nullable
    - `metadata` object, nullable: The fields you sent as `metadata` on upload, returned unchanged.
    - `width` integer, nullable
    - `height` integer, nullable
    - `size` integer, nullable: File size in bytes.
    - `mime_type` string, nullable
    - `created_at` string, date-time
  - `total` integer

## Other responses

- `401`: Missing or invalid token
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api.md) · [All operations](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/revisions/b454211e598e?raw)