Brands

List elements inside a brand

Changed on

Returns a paginated list of elements inside the specified brand. Use the cursor parameter to fetch subsequent pages.

get/brands/{assetId}/elements

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/brands/{assetId}/elements
  • Auth: HTTP bearer

Path parameters

assetIdstring required

A globally unique identifier for the asset

Example:urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174

The ID of the asset to get.

Query parameters

limitinteger

Maximum number of items per page.

startinteger

Zero-based start offset. Required when limit is specified and cursor is absent.

sortBystring

Sort order. Fields: name, created, modified. Prefix - for descending, + (optional) for ascending.

mediaTypestring

Filter elements by media type. Example: application/vnd.adobe.element.image+dcx

cursorstring

Cursor used for fetching the next set of results.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Response

Success - Paginated list of brand elements.

Example response

{
  "items": [
    {
      "elementId": "urn:aaid:sc:US:brand-element-7f8bc25d-d173-5a62-c48c-2g76fe73b285",
      "size": 1048576,
      "mediaType": "application/vnd.adobe.element.image+dcx",
      "createdDate": "2021-01-01T00:00:00Z",
      "createdBy": "46372D2768435C800A494229@techacct.adobe.com",
      "modifiedDate": "2021-01-01T00:00:00Z",
      "modifiedBy": "46372D2768435C800A494229@techacct.adobe.com",
      "elementRoles": [
        {
          "usage": "logo",
          "priority": "primary"
        }
      ]
    }
  ],
  "paging": {
    "limit": 10,
    "nextUrl": "https://api.example.com/assets?cursor=550e8400-e29b-41d4-a716-446655440000&limit=10"
  }
}

Changes