Folders

Delete folder by ID

Changed on

This endpoint deletes(soft deletion) or permanently deletes(hard deletion) an existing folder, identified by its assetId, along with all its descendant assets, from the organization’s ESM shared storage.

NOTE:

  • In order to perform hard deletion, the folder must be in DELETED state.
  • The requester must have sufficient permission to perform destructive actions on the folder.
  • If the folder is not found or access is denied, appropriate error responses will be returned.
delete/folders/{assetId}

Request

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

Query parameters

permanentboolean

Permanent used for indicating the mode of delete operation.

  • If true, the operation will do a permanent delete.
  • If false, the operation will do a soft delete.
  • If not provided, the default value is false.

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 - The folder was deleted successfully

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

    • 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

  • 01600f5358e9Revision changes
    • info

      endpoint added