Projects

Get Roles for a Project

Changed on

The endpoint retrieves the explicit roles assigned to all users and groups for a specific project, identified by its assetId. This includes only the direct access control entries defined on the project itself and does not include any roles that are inherited from parent folders or collections.

NOTE:

  • The response lists all users and groups that have direct access to the project, 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 project must exist and the requester must have at least read-level access. If the project is not found or access is denied, appropriate error responses will be returned.
get/projects/{assetId}/roles

Request

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