Brands

Get All roles for a Brand

Changed on

The endpoint retrieves the explicit roles assigned to all users and groups for a specific brand, identified by its brandId. This includes only the direct access control entries defined on the brand itself.

NOTE:

  • The response lists all users and groups that have direct access to the brand, along with their respective roles (e.g., comment, edit).
  • This data is useful for auditing and role management but does not represent the full effective access unless inheritance is also considered.
  • The brand must exist and the requester must have at least read-level access. If the brand is not found or access is denied, appropriate error responses will be returned.
get/brands/{assetId}/roles

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/brands/{assetId}/roles
  • 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 - A list of collaborators and their roles for the asset

Example response

{
  "direct": [
    {
      "id": "08D81E3B665BE5640A495C2C@AdobeOrg",
      "role": "edit"
    }
  ],
  "pending": [
    {
      "role": "edit",
      "created": "2021-01-01T00:00:00Z"
    }
  ]
}

Changes