Skip to content
Artist Alley

List the assets pinned in a collection

GET
/collections/{id}/resources

Returns assets currently pinned in this collection (excludes rows where the per-membership expires_at has passed), in sort_order ASC, added_at ASC order so the list matches the admin-arranged sequence. Joined onto assets for thumb/title without an N+1.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string format: uuid

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 50 >= 1 <= 200
cursor
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

A page of resources

object
items
required
Array<object>

One asset’s membership in a collection, joined with the asset’s identifying columns so the UI can render without a follow-up fetch.

object
collection_id
required
string format: uuid
asset_id
required
string format: uuid
sort_order
required
integer
pinned
required
boolean
expires_at
string format: date-time
nullable
added_at
required
string format: date-time
title
required
string
asset_type
required
integer format: int64
status
required
string
Allowed values: draft active archived
file_hash
required
string
nullable
file_extension
required

REQUIRED (nullable), same as Asset.file_extension. A member tile is rendered by the same CardThumb as every other surface, and CardThumb derives the media TYPE from this field alone — video / 3D badge and the sprite-scrub hover preview both key off it. Omitting it renders a collection member as an untyped still (#595).

string
nullable
thumbhash
required

REQUIRED (nullable), same as Asset.thumbhash — the member tile’s blur-up placeholder. See file_extension above for why the card-critical fields are required rather than optional.

string
nullable
preview_available
required

True iff a servable col variant exists for this asset AND the caller passes the content plane (ADR 0064). Same contract

  • 0064-safety as Asset.preview_available — the tile renders a thumbnail only when true, else a placeholder with no byte request (#471).
boolean
asset_created_at
string format: date-time
next_cursor
string
nullable

401

Section titled “401 ”

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

404

Section titled “404 ”

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed