Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Delete Asset Folder

view on GitHub

Delete Asset Folder is available as both a pgutil command and an HTTP Request, and will delete a folder at the specified path.

Command Specification (CLI)

The assets delete command is used to delete a folder in the asset directory.

The --path options is always required. The --feed option is required if there is no default feed configured.

Deleting a folder requires the asset directory (e.g. MyAssetDirectory) and folder name (e.g. old-folder):

pgutil assets delete --feed=myAssetDirectory --path=old-folder --force
  • The --force option is optional, and when used will delete a folder even if it is not empty. When not specified, the specified folder will only be deleted if empty.

HTTP Request Specification

To delete a folder, simply POST to the URL with the AssetDirectoryName and path to the folder. This HTTP request also allows for deleting files without using an DELETE request.

POST /endpoints/«AssetDirectoryName»/delete/«path»?recursive=«true/false»
  • When recursive is true, the folder and all of its contents will be deleted. It is not an error if the folder does not exist. When false or not specified and the path refers to a folder, it will only be deleted if empty.

HTTP Response Specification

Response Details
200 (Success) the item (file/folder) is deleted
400 (Directory Not Empty) when recursive is set to false, indicates that the directory is not empty
401 (Authentication Required) indicates a missing, unknown, or unauthorized API Key