List album-asset link records
Returns paginated link records (lightweight join rows between albums and assets) describing which assets are in which albums — each row contains album_id + asset_id + link timestamps, not the full asset or album metadata. Use this when you specifically need the junction records (for sync or change tracking).
For most use cases you want a different tool: use list_assets with album_id to get the full asset metadata for a specific album; use list_albums with asset_id to find which albums contain an asset.
Pagination is cursor-based: when has_more is true, pass the id of the last album-asset in data as starting_after_id to fetch the next page.
Query parameters
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.
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.
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.
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.
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).
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).
Maximum number of link records per page (1–200). Defaults to 20.
Maximum number of link records per page (1–200). Defaults to 20.
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.
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 to list from. Optional if the user has a single library; required when they have multiple.
Library to list from. Optional if the user has a single library; required when they have multiple.
Response
Successful Response