Folders
Delete a folder
Refuses a folder that still has contents unless recursive=true is sent, in which case the whole subtree goes. The refusal changes nothing, so a caller that did not mean to delete the contents can read them first and decide.
DELETE
Delete a folder
Authorizations
Workspace-scoped API key, sent as a bearer token. The recommended header. The workspace is implicit in the key and never appears in a URL.
Path Parameters
The folder id, as an earlier response reported it. Always dir_….
Example:
"dir_9f2k1x8b3m7q0v"
Query Parameters
Delete the folder together with everything below it. Left off, a folder that still has contents is refused as folder_not_empty and nothing is removed.
Example:
true
Response
Deleted. No body.