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

# List assets

`GET /assets`

Returns a paginated list of assets for the authenticated organization. Use scope=system to list system-provided assets instead.

## Query parameters

- `kind` 'media' | 'psd_template' | 'font' | 'other' — Filter by asset kind
- `scope` 'org' | 'system' — Filter by scope (defaults to org assets)
- `status` 'pending' | 'uploading' | 'ready' | 'failed' | 'expired' — Filter by status
- `lifecycle` 'ephemeral' | 'persisted' — Filter by lifecycle
- `limit` string — Items per page (default 50, max 100)
- `offset` string — Offset for pagination (default 0)

## Response `200`

Paginated list of assets

- object
  - `data` object[], required
    - `id` string, required — Asset ID (e.g., asset_abc123def456)
    - `url` string, required — Stable content URL — pass this as a job input; resolves to a presigned GET at dispatch
    - `orgId` string, required — Organization ID that owns this asset
    - `createdBy` string, nullable, required — User ID that created the asset
    - `lifecycle` string, required — ephemeral | persisted
    - `status` string, required — pending | uploading | ready | failed | expired
    - `source` string, required — upload | url | job_output
    - `kind` string, required — media | psd_template | font | other
    - `scope` string, required — org | system
    - `region` string, required — auto | eu
    - `etag` string, nullable, required — R2 etag recorded at finalize
    - `checksum` string, nullable, required — Client-declared sha256
    - `declaredSize` integer, nullable, required — Client-declared size at init
    - `sizeBytes` integer, nullable, required — Measured size at finalize
    - `contentType` string, nullable, required — MIME content type
    - `mediaType` string, nullable, required — video | image | audio | font | other
    - `filename` string, nullable, required — Sanitized display filename
    - `expiresAt` integer, nullable, required — Ephemeral TTL (Unix ms)
    - `metadata` string, nullable, required — JSON probe results
    - `createdAt` integer, required — Creation timestamp (Unix ms)
    - `updatedAt` integer, required — Last update timestamp (Unix ms)
  - `meta` object, required
    - `total` integer, required — Total matching assets
    - `limit` integer, required — Items per page
    - `offset` integer, required — Current offset

## Other responses

- `401` — Unauthorized

## Changes

> 7 revisions in range; 3 could not be searched.

- **2026-08-29** `4d10ec4266ee` — 1 info
  - api operation id `listAssets` was added

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

---

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