Download OpenAPI specification:Download
The seo-name
doesn't have a functional impact on the image, but is provided to allow for adding SEO value to
asset URLs. The assetId
is an opaque string defined by the content repository that can be used to target
the asset resource.
In the URL construction, an SEO name and an output image format must be provided. Additionally, following transforms can optionally be specified as query parameters:
rotate
crop
flip
size
preferwebp
height
width
quality
smartcrop
These are applied the order mentioned above, irrespective of where they appear in the URL. Syntax and examples for supported parameters is captured elsewhere in this document.
If-None-Match | string The For more details, please head over to RFC9110. |
Web-optimized version of the asset
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
This is a convenience API for /adobe/assets/{assetId}/as/{seoname}.{format}?...
that applies following defaults:
format
=> jpeg
/webp
(auto-determined via server-driven-content-negotiation, based on agent-declared capabilities)quality
=> 65
width
=> 1024
If-None-Match | string The For more details, please head over to RFC9110. |
Web-optimized version of the asset
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
The Original Asset Delivery API accepts an asset ID corresponding to the asset and delivers the bitstream as-is (as it was uploaded). This is a convenience API for /adobe/assets/{assetId}/renditions/{renditionName}/as/{seoname}
with renditionName
defaulting to original
.
If-None-Match | string The For more details, please head over to RFC9110. |
Original binary of the asset
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
The Asset Rendition Delivery API accepts an asset ID corresponding to the asset and the rendition name, and delivers the selected asset's specified rendition's bitstream as-is (as present on AEM Assets authoring environment).
If-None-Match | string The For more details, please head over to RFC9110. |
Binary of the specified rendition for the selected asset
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
The List Renditions API accepts an asset ID and returns the static renditions associated with the asset. A success response includes list of available renditions and their attributes.
If-None-Match | string The For more details, please head over to RFC9110. |
List of available renditions
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "assetId": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repo:name": "string",
- "items": [
- {
- "name": "2023-lexus-rx-450hl.jpg",
- "format": "image/jpeg",
- "size": 1,
- "dimensions": {
- "width": 1,
- "height": 1
}
}
]
}
Returns headers, including an ETag for the specified asset, which can be a lighter method of checking for the change in list of static renditions, without sending a full GET request.
OK
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
The Original Asset Delivery API accepts an asset ID corresponding to the asset and delivers the bitstream as-is (as it was uploaded).
This API is deprecated, please use /adobe/assets/{assetId}/original/as/{seo-name}
If-None-Match | string The For more details, please head over to RFC9110. |
Original binary of the asset
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Search Activated Assets
Asset Search Response
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "query": [
- {
- "and": [
- {
- "or": [
- {
- "match": {
- "text": "blue"
}
}, - {
- "match": {
- "text": "red"
}
}
]
}, - {
- "not": [
- {
- "term": {
- "metadata.repositoryMetadata.dc:format": [
- "video/mp4"
]
}
}
]
}
]
}, - {
- "range": {
- "metadata.repositoryMetadata.repo:size": {
- "gte": 3000000,
- "lte": 9000000
}
}
}
], - "orderBy": "metadata.repositoryMetadata.repo:size desc,metadata.repositoryMetadata.repo:createDate asc",
- "limit": 50,
- "cursor": "[1463538857, \"654323\"]"
}
{- "hits": {
- "results": [
- {
- "assetId": "urn:aaid:aem:9d68909d-378b-4c18-8b9d-0ep0g826e984",
- "repositoryMetadata": {
- "repo:name": "blue shoe.jpeg",
- "dc:format": "image/webp",
- "repo:createDate": "2023-05-29T12:54:36.410Z",
- "repo:modifyDate": "2023-05-11T14:12:09.304Z",
- "repo:size": 434292,
- "repo:repositoryId": "urn:rid:aem:65214-138691"
}, - "assetMetadata": {
- "xcm:machineKeywords": [
- {
- "localeCode": "en-US",
- "confidence": 0.7371780872344971,
- "value": "shoe"
}, - {
- "localeCode": "en-US",
- "confidence": 0.7185167074203491,
- "value": "wearable"
}
], - "tiff:ImageLength": 1800,
- "tiff:ImageWidth": 2400
}
}, - {
- "//other 8 asset metadata": null
}
]
}, - "cursor": "[\"45600323\",1478539971]",
- "search_metadata": {
- "count": 50,
- "totalCount": {
- "total": 92,
- "relation": "eq"
}, - "searchDuration": 16
}
}
Create short-lived token with access restrictions for searching assets and performing operations on specified indexes.
The API returns a token along with its validity.
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "indexes": [
- "assets",
- "collections"
], - "operationType": "search"
}
{- "token": "YTgyMzMwOTkzMjA2Mzk5OWUxNjhjYmIwMGZkNGFmMzk2NDU3ZjMyYTg1NThiZjgx",
- "expiryTime": "2024-02-28T21:39:02.417-0800",
- "appId": "5HEOA9BAT1"
}
Returns headers, including an ETag for the specified asset metadata, which can be a lighter method of checking for the existence of, or validating a cached version of an asset's metadata without sending a full GET request.
OK
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Asset metadata contains those metadata values that have been extracted from the asset, configured by the user, or derived from the asset during asset processing. Repository metadata contains metadata properties that are set and maintained by the repository during system operations.
If-None-Match | string The For more details, please head over to RFC9110. |
Metadata for the specified asset
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "value": {
- "assetId": "urn:aaid:aem:abcd1234-ab12-ab12-ab12-abcdef123456",
- "assetMetadata": {
- "xcm:keywords": [
- {
- "value": "Asset Properties : Orientation / Square",
- "@lang": "ENGLISH",
- "repo:ancestors": [
- "properties",
- "orientation",
- "square"
]
}
], - "xcm:machineKeywords": [
- {
- "value": "city",
- "confidence": 0.8512217998504639,
- "localeCode": "en-US"
}
], - "dc:creator": [
- "Photo Author"
], - "dc:description": "This is a view of a city skyline reflected in a body of water",
- "dc:title": "City skyline",
- "exif:GPSLatitude": "43,19.11N",
- "exif:GPSLongitude": "11,19.84E",
- "photoshop:ColorMode": 3,
- "photoshop:DateCreated": "2017-10-24T12:28:31.672Z",
- "tiff:BitsPerSample": [
- 8,
- 8,
- 8
], - "tiff:Orientation": 1,
- "xmp:CreateDate": "2016-08-09T00:00:00.000Z",
- "xmp:CreatorTool": "Adobe Photoshop CC 2019 (Macintosh)",
- "xmp:ModifyDate": "2019-11-21T22:02:22.000Z"
}, - "repositoryMetadata": {
- "aem:assetState": "processed",
- "aem:checkedOutBy": "testuser@test.com",
- "dam:sha1": "8601cc48d27d85ae274c954286edfde34b907e12",
- "dc:format": "image/jpeg",
- "repo:createDate": "2023-04-14T06:31:07.174Z",
- "repo:createdBy": "user@adobe.com",
- "repo:modifiedBy": "dam-writer-service",
- "repo:modifyDate": "2023-04-15T05:01:44.229Z",
- "repo:name": "city.jpeg",
- "repo:path": "/content/dam/city.jpeg",
- "repo:size": 338049,
- "repo:version": "oak:1.0::ci:y7ngaf96th56jt62awk8xkoa37c572fe",
- "tiff:imageLength": 780,
- "tiff:imageWidth": 1000,
- "repo:repositoryId": "author-p12345-e123456.adobeaemcloud.com",
- "repo:ancestors": [
- "urn:aaid:aem:abcd1234-ab12-ab12-ab12-abcdef123456"
], - "repo:state": "ACTIVE",
- "aem:published": "2023-04-22T23:26:09.036Z"
}
}
}
The Delivery API accepts an assetId, and if the ID corresponds to a video asset, delivers Player for video streaming. The asset ID is an opaque string defined by the content repository. The entity composing the Delivery URLs must know them apriori.
Response Video in Player.
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
The Delivery API accepts an asset ID, and if the ID corresponds to a video asset, delivers the playback manifest in the requested protocol. The asset ID is an opaque string defined by the content repository. The entity composing the Delivery URLs must know them apriori. If the asset is not a video asset, client gets a 404 response.
Response Video Manifests in selected format
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Creates a collection that represents a group of Asset(s) and/or Collection(s).
Returns information on the recently created collection, including its metadata.
Accepted
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
{- "title": "Product Images",
- "description": "Images approved for use in the product catalog",
- "items": [
- {
- "id": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "type": "asset"
}
]
}
{- "id": "urn:cid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repositoryMetadata": {
- "repo:repositoryId": "string",
- "repo:createDate": "2019-08-24T14:15:22Z",
- "repo:createdBy": "string",
- "repo:modifiedBy": "string",
- "repo:modifyDate": "2019-08-24T14:15:22Z"
}, - "collectionMetadata": {
- "title": "Product Images",
- "description": "Images approved for use in the product catalog"
}
}
Retrieves all the Collections available in the repository.
Collections retrieved successfully
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
{- "cursor": "string",
- "items": [
- {
- "id": "urn:cid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repositoryMetadata": {
- "repo:repositoryId": "string",
- "repo:createDate": "2019-08-24T14:15:22Z",
- "repo:createdBy": "string",
- "repo:modifiedBy": "string",
- "repo:modifyDate": "2019-08-24T14:15:22Z"
}, - "collectionMetadata": {
- "title": "Product Images",
- "description": "Images approved for use in the product catalog"
}
}
]
}
Retrieves collection metadata for a given collection id along with Etag representing the current state of the collection.
If-None-Match | string The For more details, please head over to RFC9110. |
X-Adobe-Accept-Experimental required | integer Value: 1 |
Collection Metadata Retrieved successfully
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "id": "urn:cid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repositoryMetadata": {
- "repo:repositoryId": "string",
- "repo:createDate": "2019-08-24T14:15:22Z",
- "repo:createdBy": "string",
- "repo:modifiedBy": "string",
- "repo:modifyDate": "2019-08-24T14:15:22Z"
}, - "collectionMetadata": {
- "title": "Product Images",
- "description": "Images approved for use in the product catalog"
}
}
Returns headers, including an ETag for the specified collection, which can be a lighter method of checking for the existence of, or validating a cached version of an collection without sending a full GET request.
OK
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Deletes a collection for a given collection id. If the delete operation requires more than a few seconds to complete, a status link with the jobId is returned in the response header that can be used to check the status.
If-Match required | string The For more details, please head over to RFC9110. |
Accepted
Collection deleted successfully.
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
Precondition Failed
Precondition Required
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Updates the metadata for a given collection id.
If-Match required | string The For more details, please head over to RFC9110. |
No Content
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
Precondition Failed
Precondition Required
{- "title": "New Title",
- "description": "New Description"
}
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Retrieve a paginated list of the items in the specified collection.
If-None-Match | string The For more details, please head over to RFC9110. |
X-Adobe-Accept-Experimental required | integer Value: 1 |
Collection Retrieved successfully
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "cursor": "string",
- "self": [
- {
- "id": "urn:cid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repositoryMetadata": {
- "repo:repositoryId": "string",
- "repo:createDate": "2019-08-24T14:15:22Z",
- "repo:createdBy": "string",
- "repo:modifiedBy": "string",
- "repo:modifyDate": "2019-08-24T14:15:22Z"
}, - "collectionMetadata": {
- "title": "Product Images",
- "description": "Images approved for use in the product catalog"
}
}
], - "items": [
- {
- "id": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repo:repositoryId": "string",
- "type": "asset"
}
]
}
Returns headers, including an ETag for the specified assets collection, which can be a lighter method of checking for the existence of, or validating a cached version of an collection without sending a full GET request.
OK
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
If the update operation requires more than a few seconds to complete, response includes a Location
header which contains the URL to poll for status of this operation.
If-Match required | string The For more details, please head over to RFC9110. |
Adds or removes an item from the collection.
Accepted
No Content
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
Precondition Failed
Precondition Required
[- {
- "op": "remove",
- "id": "urn:aaid:aem:fc472a53-4ef1-4fdb-8ebb-f9b1ee75985w",
- "type": "asset"
}, - {
- "op": "add",
- "id": "urn:aaid:aem:fc472a53-4ef1-4fdb-8ebb-f9b1ee75985w",
- "type": "asset"
}
]
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Retrieves the current job's status for a collection.
Status of a task being processed
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
{- "operation": "aem.assets.collections.deleteCollection",
- "status": 200,
- "description": "Collection deleted successfully",
- "data": {
- "id": "12a020e8-ca19-44aa-91fa-c1c0db97edff",
- "collectionId": "urn:cid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "status": "COMPLETED"
}, - "errors": [ ],
- "warnings": [
- {
- "title": "Not Found",
- "detail": "Asset 'xyz-123' could not be found"
}
]
}
This endpoint allows users to create new link for given assets or collections, with the provided details.
Returns shareable links for the requested assets or collections, along with link metadata
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "assets": [
- {
- "assetId": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75"
}
], - "title": "Sample link",
- "access": "public",
- "expiryTime": "2021-05-20T20:00:00.000Z"
}
{- "id": "6ba7b8109dad11d180b40002a5d5c51b62xsa4uT0qO_hvyym329pOYFasfPffVM9E-IPgs9KM",
- "title": "Sample link",
- "access": "public",
- "sharedItemsCount": 1,
- "expiryTime": "2021-05-20T20:00:00.000Z",
- "owner": "user@adobe.com"
}
Retrieves a list of non-expired shared links.
This endpoint allows users to retrieve a list of shared links that are currently non-expired and accessible.
Response list of non-expired shared links
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "links": [
- {
- "id": "6ba7b8109dad11d180b40002a5d5c51b62xsa4uT0qO_hvyym329pOYFasfPffVM9E-IPgs9KM",
- "title": "Sample link",
- "access": "public",
- "sharedItemsCount": 1,
- "expiryTime": "2021-05-20T20:00:00.000Z",
- "owner": "user@adobe.com"
}
]
}
Get detailed information about a shared link, including associated assets or collections URLs.
This endpoint allows users to fetch information about a specific shared link by providing its unique identifier.
Response of shared link containing shared assets or collections
Not Modified
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "assets": [
- {
- "assetId": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "token": "T0lUJUypSG06pJabw3guL6kNRfz6S3wP6nA2gRlXERI",
- "expiryTime": "2021-05-20T20:00:00.000Z"
}
], - "id": "6ba7b8109dad11d180b40002a5d5c51b62xsa4uT0qO_hvyym329pOYFasfPffVM9E-IPgs9KM",
- "title": "Sample link",
- "access": "public",
- "sharedItemsCount": 1,
- "expiryTime": "2021-05-20T20:00:00.000Z",
- "owner": "user@adobe.com"
}
This endpoint allows users to delete a shared link by providing its unique identifier.
Link deleted successfully.
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Not Found
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "title": "Bad Request",
- "status": 400,
- "detail": "Bad request, please check that you have provided the correct parameters and that they are valid."
}
Event triggered when an asset can no longer be rendered through new DM APIs. This is used by applications when processing of asset(s) in delivery tier takes a long time, for example, video assets or assets going through any ML pipeline.
id required | string non-empty An identifier for the event. When used in combination with the |
source required | string <uri> non-empty ^acct:aem(-cmstg)?-p\d+-e\d+@adobe\.com$ An instance of the acct URI scheme that uniquely identifies the
producer of this event, of the format |
specversion required | string >= 3 characters The version of the CloudEvents specification which the event uses. AEM events use the CloudEvents spec version 1.0.2, hence this value will be 1.0. |
type required | string >= 4 characters ^aem\..*$ The type for the event. This will identify the AEM solution that has dispatched the event and may also include the type of entity and the activity that occurred. |
datacontenttype required | string non-empty The format of the data in the event. This will always be |
dataschema | string <uri> An optional attribute, which may point to a JSON schema document that covers the data object. |
time required | string <date-time> non-empty A timestamp of when the event occurred. |
required | object The event payload. |
Asset delivery disabled event data is received successfully
{- "specversion": "1.0",
- "type": "aem.assets.asset.removed_from_delivery",
- "source": "acct:aem-p56789-e12345@adobe.com",
- "id": "7c1104e5-4cd7-47d6-a50f-2568c480f2e9",
- "time": "2018-04-05T17:31:00Z",
- "datacontenttype": "application/json",
- "data": {
- "myProp": "myValue",
- "assetId": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75"
}
}
Event triggered when an asset is ready for delivery through new DM APIs. This is used by applications when processing of asset(s) in delivery tier takes a long time, for example, video assets or assets going through any ML pipeline.
id required | string non-empty An identifier for the event. When used in combination with the |
source required | string <uri> non-empty ^acct:aem(-cmstg)?-p\d+-e\d+@adobe\.com$ An instance of the acct URI scheme that uniquely identifies the
producer of this event, of the format |
specversion required | string >= 3 characters The version of the CloudEvents specification which the event uses. AEM events use the CloudEvents spec version 1.0.2, hence this value will be 1.0. |
type required | string >= 4 characters ^aem\..*$ The type for the event. This will identify the AEM solution that has dispatched the event and may also include the type of entity and the activity that occurred. |
datacontenttype required | string non-empty The format of the data in the event. This will always be |
dataschema | string <uri> An optional attribute, which may point to a JSON schema document that covers the data object. |
time required | string <date-time> non-empty A timestamp of when the event occurred. |
required | object The event payload. |
Asset delivery ready event data is received successfully
{- "specversion": "1.0",
- "type": "aem.assets.asset.ready_for_delivery",
- "source": "acct:aem-p56789-e12345@adobe.com",
- "id": "7c1104e5-4cd7-47d6-a50f-2568c480f2e9",
- "time": "2018-04-05T17:31:00Z",
- "datacontenttype": "application/json",
- "data": {
- "myProp": "myValue",
- "value": {
- "assetId": "urn:aaid:aem:abcd1234-ab12-ab12-ab12-abcdef123456",
- "assetMetadata": {
- "xcm:machineKeywords": [
- {
- "value": "city",
- "confidence": 0.8512217998504639,
- "localeCode": "en-US"
}
], - "pur:expirationDate": "2023-04-17T06:31:07.174Z"
}, - "repositoryMetadata": {
- "aem:assetState": "processed",
- "aem:checkedOutBy": "testuser@test.com",
- "dam:sha1": "8601cc48d27d85ae274c954286edfde34b907e12",
- "dc:format": "image/jpeg",
- "repo:createDate": "2023-04-14T06:31:07.174Z",
- "repo:createdBy": "user@adobe.com",
- "repo:modifiedBy": "dam-writer-service",
- "repo:modifyDate": "2023-04-15T05:01:44.229Z",
- "repo:name": "city.jpeg",
- "repo:path": "/content/dam/city.jpeg",
- "repo:size": 338049,
- "repo:version": "oak:1.0::ci:y7ngaf96th56jt62awk8xkoa37c572fe",
- "tiff:imageLength": 780,
- "tiff:imageWidth": 1000,
- "repo:repositoryId": "author-p12345-e123456.adobeaemcloud.com",
- "repo:ancestors": [
- "urn:aaid:aem:abcd1234-ab12-ab12-ab12-abcdef123456"
], - "repo:state": "ACTIVE",
- "aem:published": "2023-04-22T23:26:09.036Z"
}
}
}
}
APIs for generating archives containing binaries (one or more assets, with one or more renditions) in one of the supported archival formats (e.g., zip
).
Request creation of an archive for the asset references specified in the request payload. The response contains an identifier and metadata pertaining to the archive request.
The result of the operation will be one or more archives. The API may use various factors to determine the number of archives required to complete the operation. For example, very large archive request might be split into multiple files.
Consumers of this API should use the response Location
header to poll for the status of the archive creation request. The polling interval should be determined by the Retry-After
header value.
Invalid assets specified for inclusion in the archive will not fail the overall creation process. Instead, the API will create a archive containing the assets it could find, with invalid asset references appearing as warnings in the final status response.
required | Array of objects non-empty Assets to be included in the archive. By default, any custom renditions generated via Processing Profiles and original rendition can optionally specify renditions that MUST be included-in or excluded-from the archive being requested. |
format | string (ArchiveFormat) Default: "zip" The output format of the archive |
namePrefix | string The name to use for the created archive file(s). Note that the API will treat this as a suggestion, and reserves the right to change the final archive name as needed. If not provided, the API will assign its own file name according to any logic it deems fit. |
Accepted
Bad Request. The Problem Details object will provide more information about the exact cause.
Unauthorized
Forbidden
Unsupported Media Type. When provided as a response to a PATCH
request,
the response will provide an Accept-Patch
response header to notify
the client what patch document media types are supported.
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "items": [
- {
- "assetId": "urn:aaid:aem:1a034bee-ebda-4787-bad3-f924d0772b75",
- "repo:repositoryId": "author-p12345-e12345.adobeaemcloud.com",
- "includeRenditions": [
- "thumbnail.319.png",
- "customRenditionName.png"
], - "excludeRenditions": [
- "original"
]
}
], - "format": "zip",
- "namePrefix": "assets"
}
{- "id": "1a034bee-ebda-4787-bad3-f924d0772b75",
- "format": "zip",
- "submittedBy": "person@company.com",
- "submittedDate": "2024-02-28T21:39:02.417-0800"
}
Get the status of the archive creation request
Ok
Unauthorized
Forbidden
Not Found
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "operation": "aem.assets.archives.createArchive",
- "status": 200,
- "description": "Archive created successfully",
- "data": {
- "id": "12a020e8-ca19-44aa-91fa-c1c0db97edff",
- "format": "zip",
- "submittedBy": "person@company.com",
- "submittedDate": "2024-02-28T21:39:02.417-0800",
- "status": "COMPLETED",
- "completionDate": "2024-02-28T21:50:31.346-0800",
}, - "errors": [ ],
- "warnings": [
- {
- "title": "Not Found",
- "detail": "Asset 'xyz-123' could not be found"
}
]
}
For a given archiveId
, one or more archive files can be created.
Archival Request Status API provides the list of archive files available for the archiveId
. This API enables download of any/all of those files.
Found
Not Found
The server encountered an unexpected error. Retrying the request after a certain time could help.
{- "title": "Not Found",
- "status": 404,
- "detail": "The requested resource could not be found."
}