Skip to main content
DELETE
Delete folder
Deletes a folder. The folder must be empty — contain no child folders and no secrets — before deletion.
For ACB deployments updated from a version prior to 1.2, switch to the https://{hostname}/EkranACB server in the Playground.

Permissions required

The user owning the Access Token must have Owner role on the folder.

Errors

See Status codes. Common errors:
  • 403 Forbidden — user lacks Owner role.
  • 404 Not Found — folder doesn’t exist.
  • 409 Conflict — folder is not empty. Remove its contents first.

Get folder

Verify folder existence before deletion.

Delete secret

Remove secrets from the folder first.

Update folder

Move (don’t delete) a folder by changing its parent.

API reference

Status codes.

Authorizations

Authorization
string
header
required

Access token for authentication

Path Parameters

id
integer<int32>
required

The ID of the folder to delete

Required range: x >= 1

Response

Folder deleted successfully