Single Asset Group
Asset Group in a Data Manager. Asset Groups are used to organize Assets. Every (non-legacy) asset belongs to exactly one Asset Group. Asset Groups can have settings that overwrite the global or Data Manager settings for its assets. Also, an Asset Group defines if the file URLs of its Asset are signed URLs or just plain URLs. This can never change in an Asset Group.
The JSON Schema is https://entrecode.de/schema/dm-assetgroup.
||The unique identifier for an asset group||Yes, but only on creation. Cannot be changed afterwards.|
|public||Boolean||true/false||Indicating if assets in this group are generally public or have signed URLs.||Yes, but only on creation. Cannot be changed afterwards.|
|settings.urlExpiration||String||ISO-8601 formatted Duration String (PXXX…, RFC 3339)||How long URLs will be valid, if this assetgroup is non-public. Overwrites global setting from Data Manager.||Yes|
|settings.disabledTypes||Array[String]||Array of either types ("image", "video", "audio", "plain", "document", "spreadsheet", "other") or mime-types.||List of asset types and mime types that may not be used in this group.||Yes, but values can only be removed.|
|settings.imageSizes||Array[Integer]||List of available image sizes.||Yes, but values can only be added.|
|settings.thumbSizes||Array[Integer]||List of available thumbnail sizes.||Yes, but values can only be added.|
|settings.preserveFilenames||Boolean||Set if by default the file name should be part of the URL. Can be overridden on upload.||Yes|
|settings.includeAssetIDInPath||Boolean||Set if by default the file name should include the assetID for uniqueness. To be used together with preserveFilenames. Can be overridden on upload.||Yes|
|policies||Array[JSON]||Policy Definition||Permission Policies for Assets in this Asset Group||Yes|
||The method the policy should apply to.||Yes|
||The user type the policy should apply to.||Yes|
||See https://entrecode.de/schema/dm-assetgroup#definitions/conditions||Additional conditions the assets need to fulfill.||Yes|
|Relation Name||Target Resource||Description||Possible Methods|
|self||Asset Group||The resource itself||GET, PUT|
|collection||Asset Group List||List of all available Asset Group||GET, POST|
|ec:datamanager||Data Manager||The Data Manager this Asset Group belongs to||GET, PUT|
|ec:dm-assets||Asset List||The Assets of this Asset Group||GET, POST|
The Asset Group List Resource is a Generic List Resource with embedded Asset Group Resources.
To read a single Asset Group Resource, clients may perform GET on a
To read the Asset Group List Resource, clients may perform GET on a
ec:dm-assetgroups relation or on the
collection relation of a single Asset Group resource.
In both cases, the success status code is 200 OK.
To create a new Asset Group, clients may perform a POST on
ec:dm-assetgroups (the list resource). The JSON Schema for creating a new Asset Group is https://entrecode.de/schema/dm-assetgroup-template-post.
The success status code is 201 Created and the response body is the newly created single Asset Group resource.
To update an existing Asset Group Resource, clients may perform a PUT on
self at a single Asset Group Resource. The JSON Schema for editing a Asset Group is https://entrecode.de/schema/dm-assetgroup-template-put.
All fields are optional. Some changes are restricted (see table above).
The success status code is 200 OK and the response body is the updated single Asset Group resource.
Deleting an Asset Group is currently not possible.