Brands

Get a brand by ID

Changed on

This endpoint retrieves full metadata for a specific Brand identified by its assetId.

get/brands/{assetId}

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/brands/{assetId}
  • 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.

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 - Retrieved information about the brand

assetIdstring required

A globally unique identifier for the asset

namestring required

Human-readable name of the asset

createdDatestring date-time
modifiedDatestring date-time
createdBystring

The Unique ID for the principal in the system

modifiedBystring

The Unique ID for the principal in the system

pathstring

The path of the asset from the parent collection.

ancestorsAssetId[]

Ordered list of ancestor asset IDs (first is immediate parent).

state'active' | 'deleted' | 'deleted_parent'

Current state of the asset

assetTypestring required
mediaTypestring required

The MIME type of the file

sizeinteger required

Size of the file in bytes

elementsCountinteger

The number of elements inside the brand

Example response

{
  "assetId": "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
  "name": "My Asset",
  "createdDate": "2021-01-01T00:00:00Z",
  "modifiedDate": "2021-01-01T00:00:00Z",
  "createdBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
  "modifiedBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
  "path": "/My Project/My Folder/My Asset",
  "ancestors": [
    "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
    "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a175",
    "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a176"
  ],
  "mediaType": "image/jpeg",
  "size": 1048576
}

Changes