API reference
The Adobe Cloud Storage and Collaboration API provides programmatic access to content stored in Adobe Cloud Storage for your organization. With the Adobe Cloud Storage and Collaboration API, you can interact with projects, folders, and files to automate creative production workflows and integrate Adobe Cloud Storage with your existing systems.
Connecting to the Cloud Storage and Collaboration API
Before using the Cloud Storage and Collaboration API, you must create a development project in the Adobe Developer Console. This integration registers your application as a client of the Cloud Storage and Collaboration API, and provides the credentials required to authorize API calls.
- For setup instructions, see Developer Console
- For information about client credential authentication and retrieving Client ID, Client Secret, Scopes, or access tokens, see Authentication Setup.
Cloud Storage API Calls
Applications can use the API to access and manage projects, folders, and files in Adobe enterprise cloud storage. You can create and list projects, assign user roles, manage folders, upload and download files, and more.
For more information on content structures, see Cloud Storage and Collaboration Concepts.
All API requests should be directed to the Cloud Storage and Collaboration API server:
https://cloudstorage.adobe.io/v1
Summary of Actions on Cloud Content
Projects
Projects are durable spaces used by teams to organize and collaborate on cloud documents and related cloud content.
Task
Operation
Endpoint
Description
GET
/projects
Returns a paginated list of all projects within the organization's enterprise shared storage
POST
/projects
Creates a new project within the organization's enterprise shared storage
GET
/projects/{assetId}
Retrieves full metadata for a specific project
DELETE
/projects/{assetId}
Deletes a project by ID, along with all its descendant assets
POST
/projects/{assetId}/rename
Renames a project
POST
/projects/{assetId}/restore
Restores a soft-deleted project
GET
/projects/{assetId}/children
Retrieves a paginated list of top-level children (folders, files, or other resources) contained within a specified project
GET
/projects/{assetId}/effective-permission
Retrieves the effective permission (role) assigned to the user for a specific project
GET
/projects/{assetId}/roles
Retrieves the explicit roles assigned to all users and groups for a specific project
PATCH
/projects/{assetId}/roles
Adds, updates, or removes roles for a specific project
GET
/projects/{assetId}/permissions
Deprecated. Use /projects/{assetId}/roles instead
PATCH
/projects/{assetId}/permissions
Deprecated. Use /projects/{assetId}/roles instead
POST
/projects/{projectId}/references
Adds a reference (link) to a brand within a project. A project can have a maximum of 200 references
GET
/projects/{projectId}/references
Returns a list of brand references associated with the specified project
DELETE
/projects/{projectId}/references/{referenceId}
Removes a brand reference from a project
Folders
Folders can contain files and other folders, enabling logical organization of assets.
Task
Operation
Endpoint
Description
POST
/folders
Creates a folder under a specified parent container (project or another folder)
GET
/folders/{assetId}
Retrieves full metadata for a specific folder
DELETE
/folders/{assetId}
Deletes a folder by ID, along with all its descendant assets
POST
/folders/{assetId}/rename
Renames a folder
POST
/folders/{assetId}/restore
Restores a soft-deleted folder
GET
/folders/{assetId}/children
Retrieves a paginated list of top-level children (folders, files, or other resources) contained within a specified folder
GET
/folders/{assetId}/effective-permission
Retrieves the effective permission (role) assigned to the user for a specific folder
Files
Files are used to store content in Adobe cloud storage. See Cloud Storage and Collaboration Concepts for more information about files and file types.
Task
Operation
Endpoint
Description
GET
/files/{assetId}
Retrieves full metadata for a specific file
DELETE
/files/{assetId}
Deletes a file by ID
POST
/files/{assetId}/rename
Renames a file
POST
/files/{assetId}/restore
Restores a soft-deleted file
GET
/files/{assetId}/effective-permission
Retrieves the effective permission (role) assigned to the user for a specific file
GET
/files/{assetId}/roles
Retrieves the explicit roles assigned to all users and groups for a specific file
PATCH
/files/{assetId}/roles
Adds, updates, or removes roles for a specific file
GET
/files/{assetId}/permissions
Deprecated. Use /files/{assetId}/roles instead
PATCH
/files/{assetId}/permissions
Deprecated. Use /files/{assetId}/roles instead
POST
/files/{assetId}/copy
Copies a file to a new location. Returns a job ID to track the asynchronous operation
POST
/files/{assetId}/move
Moves a file to a new location. Returns a job ID to track the asynchronous operation
GET
/files/{assetId}/download
Creates pre-signed URLs for downloading a file
GET
/files/{assetId}/image-rendition
Returns an image rendition of the specified file
POST
/files/upload/init
Initiates the uploading of a file to Adobe cloud storage. Supports multiple blocks for large files
POST
/files/upload/finalize
Finalizes the block upload process by initiating an asynchronous job that will merge all uploaded blocks and creates the final file asset
POST
/files/{assetId}/upload/init
Initiates uploading a new version of an existing file. Supports multiple blocks for large files
POST
/files/{assetId}/upload/finalize
Finalizes the block upload process and replaces the existing file with the newly uploaded version
Brands
Brands are collections of reusable assets and guidelines for content reuse across documents. They contain elements such as logos, colors, fonts, and graphics.
Task
Operation
Endpoint
Description
POST
/brands
Creates an empty brand within a specified project
GET
/brands/{assetId}
Retrieves full metadata for a specific brand
DELETE
/brands/{assetId}
Soft or permanently deletes a brand by ID
POST
/brands/{assetId}/rename
Renames a brand
GET
/brands/{assetId}/elements
Returns a paginated list of elements inside the specified brand
POST
/brands/{assetId}/elements/init
Initializes a block-based upload session for a new binary element (logos, images) within a brand
POST
/brands/{assetId}/elements/finalize
Finalizes a block-based binary upload for a brand element. Returns a job ID to track the asynchronous operation
POST
/brands/{assetId}/elements/content
Creates a JSON-based element (font definition or color theme) within a brand synchronously
GET
/brands/{assetId}/elements/{elementId}
Returns detailed information about a single element inside a brand
DELETE
/brands/{assetId}/elements/{elementId}
Deletes an element from the specified brand
GET
/brands/{assetId}/elements/{elementId}/content
Returns the inline JSON content of a brand element (fonts, color themes)
GET
/brands/{assetId}/roles
Retrieves the explicit roles assigned to all users and groups for a specific brand
PATCH
/brands/{assetId}/roles
Adds, updates, or removes roles for a specific brand
GET
/brands/{assetId}/effective-permission
Retrieves the effective permission (role) assigned to the user for a specific brand
Jobs Operations
Manages asynchronous jobs in the system.
Task
Operation
Endpoint
Description
GET
/status/{jobId}
Retrieves the current status of an asynchronous job
What's next?
Explore Adobe Cloud Storage and Collaboration API specifications.