AdmiralCloud Developer Platform
API v5

Introduction

Every media item on AdmiralCloud is a mediaContainer. All collections (private or group collection) as well as publicareas (press area, mediahub) are mediaContainers as well.

Availability of mediacontainers for external publishing

There are a lot of parameters that define it a mediacontainer is available for external pages (such as weblinks, projects/public areas, mediahubs etc).

  • Flag -> only mediacontainers with flag 0 are available for external links
  • start and end date -> if start and/or end date are set, they determine the available time range
  • settings for embedLinkNotAllowed, publicAreaNotAllowed, downloadNotAllowed, downloadOriginalNotAllowed

Deleting mediacontainers

MediaContainers are usually put in trash when a user deletes it. Exceptions are dropsites, downloadlinks, pinboard, collections and miscellaneous media type like avatar, watermark, contactPictures or welcomeBackgrounds.

MediaContainers with media content

If a mediaContainer of type video, audio, image or document is put into trash all connection to publicareas and other mediacontainers are immediately removed. All other data related to the mediacontainer (e.g. chapters, subtitles, etc) remain intact and can be restored.

Embedlinks remain also intact but are deactivated. They are automatically restored if a mediaContainer is restored from trash.

modelCounts for this mediaContainer will reflect the changes, so embedlinks will be shown as 0. modelCounts for tags the mediaContainer uses will also reflect the change, although the relation itself remains intact.

MediaContainers of type publicarea

For mediaContainers which are publicareas the deletion will update all related mediacontainer documents, but the relation itself (between publicarea and mediacontainer) remains intact. This way, restoring a mediaContainer of type publicarea will also bring back all mediacontainer relations.

Reference

Live API reference

Loading API reference…