Files

Delete file by ID

Changed on

This endpoint deletes(soft deletion) or permanently deletes(hard deletion) an existing file, identified by its assetId, from the organization’s ESM shared storage.

NOTE:

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

Request

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

  • 01600f5358e9Revision changes
    • info

      endpoint added