Link relation aa:delete-asset-by-id

Overview

Delete the entire asset or the media of the asset, depending on the given mode.

Deletion will fail if the asset is reserved. You can use the query parameter override-reservations to override reservations.

This link relation may not be available for all system types.

HTTP method

DELETE

URL template parameters

-

Query parameters

mode

New in MC | Cloud UX 2023.12

Deletion mode. Currently only supported for MC|AM. Possible values:

  • media: delete only the essences and associated media files.

  • all: delete the entire asset, including the essences and associated media files.

Default is "all".

override-reservations

New in MC | Cloud UX 2023.12

Override reservations on the asset. Currently only supported for MC|AM. Possible values:

  • none: do not override reservations. If the asset is reserved, deletion will fail.

  • media: override reservations on the asset when using deletion mode "media".

  • all: override all reservations on the asset.

Default is "none".

Request body

-

HTTP response

204 No Content

The asset was deleted.

403 Forbidden

Deleting the asset was denied.

405 Method not allowed

The asset is reserved.

Response body

-

Available in