Skip to main content
GET
List album-asset link records

Query Parameters

album_id
string | null

Return only link records for this album ID. Equivalent to 'list the assets in this album' — in most cases prefer list_assets with album_id to get the asset metadata directly instead of the lightweight link records.

asset_id
string | null

Return only link records for this asset ID. Equivalent to 'which albums contain this asset' — in most cases prefer list_albums with asset_id to get the album metadata directly.

ids
string[] | null

Look up specific album-asset link records by ID (max 200). The ID has the album_asset_ prefix. Accepts multiple ids= query params or a single comma-delimited value (e.g., ids=album_asset_1,album_asset_2).

limit
integer
default:20

Maximum number of link records per page (1–200). Defaults to 20.

Required range: 1 <= x <= 200
starting_after_id
string | null

Cursor for pagination. Pass the id of the last album-asset in the previous response's data to fetch the next page. Omit for the first page.

library_id
string | null

Library to list from. Optional if the user has a single library; required when they have multiple.

Response

Successful Response

data
AlbumAssetResponse · object[]
required

List of album-asset links

has_more
boolean
required

True if there are more album-asset links after this page. Pass the last album-asset's id as starting_after_id to fetch the next page.