Add existing assets to an album

curl --request POST \
  --url https://api.example.com/api/albums/{album_id}/assets \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset_ids": [
    "<string>"
  ]
}
'

{
  "added_assets": [
    "<string>"
  ],
  "duplicate_assets": [
    "<string>"
  ],
  "not_found_assets": [
    "<string>"
  ]
}

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 100 ids per request; over-cap requests return 422.

POST

api

albums

{album_id}

assets

Add existing assets to an album

curl --request POST \
  --url https://api.example.com/api/albums/{album_id}/assets \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset_ids": [
    "<string>"
  ]
}
'

{
  "added_assets": [
    "<string>"
  ],
  "duplicate_assets": [
    "<string>"
  ],
  "not_found_assets": [
    "<string>"
  ]
}

Path Parameters

album_id

string

required

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

Body

application/json

asset_ids

string[]

required

Asset IDs (with asset_ prefix) to associate with the album. Get IDs from list_assets, search_assets, or list_album_assets. Up to 100 ids per request.

Maximum array length: 100

Response

Successful Response

added_assets

string[]

required

Asset IDs newly added to the album by this call.

duplicate_assets

string[]

required

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

not_found_assets

string[]

required

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

Update an album

Remove assets from an album