---
title: "Get an asset"
method: GET
path: "/v1/assets/{id}"
tags: ["Assets"]
---

# Get an asset

`GET /v1/assets/{id}`

## Request

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

## Response `200`

Asset

- 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

## Other responses

- `401`: Missing or invalid token
- `404`: Asset not found
- `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/7f7d4a72b17c?raw)