v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB

albums

Add existing assets to an album

Adds one or more existing assets to the specified album. Assets must already be in the same library as the album (this tool does not upload new assets). Assets already in the album are silently skipped and returned separately as duplicate_assets; missing or different-library IDs are skipped and returned as not_found_assets. Idempotent: calling with the same IDs twice leaves the album in the same state.

Up to 200 ids per request; over-cap requests return 422.

post/api/albums/{album_id}/assets

Path parameters

album_idstring required

Album ID (with album_ prefix) of the album to add the assets to.

Request body

asset_idsstring[] required

Asset IDs (with asset_ prefix) to associate with the album. Up to 200 ids per request.

Response

Successful Response

added_assetsstring[] required

Asset IDs newly added to the album by this call.

duplicate_assetsstring[] required

Asset IDs that were already in the album and were skipped (idempotent no-op, not an error).

not_found_assetsstring[] required

Asset IDs that were skipped because they do not exist or do not belong to the album's library.