List variant files (palette swaps, transcodes, thumbnails) for an asset

GET

/assets/{id}/alternates

• Local development behind nginx (port 8088 by default)

Returns the sibling-version variants attached to this asset, most-recently-created first. Where companions are sidecars the primary asset references, alternates are variants of the asset itself — a palette-swapped sprite sheet, a web-res thumbnail, a transcoded proxy. Each alternate stands on its own and can be downloaded directly.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

List of alternates (may be empty)

Array<object>

A sibling-version variant of an asset (palette swap, transcode, thumbnail, authored variant). Where companions are sidecars the primary asset references, alternates stand on their own and can be downloaded individually.

object

id

required

string format: uuid

asset_id

required

string format: uuid

label

required

Human label shown in alt-file lists; unique per asset.

string

Example

walk — team-green palette

kind

required

Provenance tag — palette_swap | thumbnail | low_res | authored | transcode. Open-ended.

string

Example

palette_swap

content_type

required

string

Example

image/png

size_bytes

required

integer format: int64

origin_server_id

string format: uuid

nullable

created_by_user_ref

required

integer format: int64

nullable

created_at

required

string format: date-time

metadata

required

Kind-specific JSON. Sprite tool palette swaps store the colour remap here.

object

key

additional properties

any

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

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed