assets

Move assets to another library

Changed on

Moves the given assets from one library to another, keeping their IDs and stored files. The caller must own the source library and either own the destination library or be a collaborator on it. A scoped credential must cover both libraries and allow both delete_permanently and write. Moved assets leave the source library's albums, people, and stacks.

Returns 200 with one result per asset even when some assets could not be moved. Each result describes the asset's state when the request ran, so repeating a request is safe: an asset already in the destination library is reported as a success.

Returns 409 when a concurrent change interrupted the request; nothing was moved, so retry it unchanged. Returns 503 while moving assets is turned off; retry later.

post/api/assets/move

Request

  • Base URL: https://api.gumnut.ai
  • URL: https://api.gumnut.ai/api/assets/move
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

source_library_idstring required

Library the assets are in now. The caller must own it.

destination_library_idstring required

Library to move the assets into. The caller must own it or be a collaborator on it. Must differ from source_library_id.

asset_idsstring[] required

Asset IDs (each with the asset_ prefix) to move.

Response

Successful Response

Changes