Projects

Get User's Effective Permissions for a Project

Changed on

The endpoint retrieves the effective permission (role) assigned to the user for a specific project, identified by its assetId. It evaluates the users access based on:

  • Direct permissions assigned to the project.
  • Predefined principals, such as orgEverybody or group-based access rules.
get/projects/{assetId}/effective-permission

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/projects/{assetId}/effective-permission
  • 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 - Effective permission for the user for a project asset

role'edit' | 'comment' | 'undefined'

It describes the level of access granted for an asset to a subject.
Following roles are supported:

  • edit - The subject has edit access to the asset. It includes all permissions of the comment role as well as the ability to share the asset with other users.
  • comment - The subject has comment access to the asset. It includes the ability to view the asset and add comments to it.
  • undefined - In some cases, a permission that cannot be expressed by edit or comment is returned as undefined. The user has some underlying permission to the asset, but the access is not specific enough to be classified as edit or comment. User operations may be limited.

NOTE:
This list is not exhaustive and will be updated as roles are added. Clients should expect new roles to be added in the future.

Example response

{
  "role": "edit"
}

Changes

  • 240b6278279cRevision changes
    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • info

      response property role deprecated

    • info

      added the required property to the response with the status

  • 01600f5358e9Revision changes
    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new undefined enum value to the response property for the response status