albums

Add existing assets to an album

Changed on

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.

post/api/albums/{album_id}/assets

Request

  • Base URL
    https://api.gumnut.ai
  • Auth
    • HTTP bearer
    • or HTTP bearer

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.

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • breaking

      response property detail list-of-types was widened by adding types string to media type application/json of response 422

    • info

      the response property became required for the status