Brands

Create a JSON brand element

Changed on

Creates a new JSON-based element (such as a font definition or color theme) within a Brand identified by its assetId. Unlike binary element upload, this endpoint accepts the element content directly as the data part of a multipart request and returns the created element synchronously.

The Content-Type of the data part determines the element's media type and must be a supported JSON element media type (e.g. application/vnd.adobe.element.font+json or application/vnd.adobe.element.colortheme+json).

post/brands/{assetId}/elements/content

Request

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

Created - The brand element was successfully created.

elementIdstring required

Unique element identifier.

namestring required

The name of the asset (including the extension, in case of a file)

The name must not be a

  • reserved Windows name
    • CON
    • PRN
    • AUX
    • NUL
    • COM1 through COM9
    • LPT1 through LPT9
  • contain any of the following characters:
    • \
    • /
    • :
    • *
    • ?
    • "
    • |
    • >
    • <
sizeinteger required

The size of the file in bytes.

mediaTypestring required

The media type of the brand element.

createdDatestring date-time required
createdBystring required

The Unique ID for the user in the system

modifiedDatestring date-time required
modifiedBystring required

The Unique ID for the user in the system

Example response

{
  "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"
    }
  ]
}

Changes