Skip to main content
POST
Add new folder
Creates a new folder for organizing secrets. Returns the created folder including its assigned ID.
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 parent folder (or be allowed to create root-level folders).

Tips

  • parent_folder_id and parent_folder_name are mutually exclusive. Use one or the other to identify the parent.
  • Set permissions at the folder level when onboarding many secrets — granting an API consumer Editor on the folder cascades to every secret it contains.

Errors

See Status codes. Common errors:
  • 400 Bad Request — name missing or invalid permissions structure.
  • 403 Forbidden — user lacks Owner role on the parent folder.
  • 409 Conflict — folder name already exists in the target parent.

Get folder

Read folder details.

Update folder

Modify an existing folder.

Bulk add

Create folders + secrets in a single call.

Add secret

Add secrets to this folder.

Authorizations

Authorization
string
header
required

Access token for authentication

Body

application/json
name
string
required

Name of the folder

Maximum string length: 512
description
string

Description of the folder

Maximum string length: 2000
parent_folder_id
integer<int32>

ID of the parent folder

Required range: x >= 0
parent_folder_name
string

Name of the parent folder

Maximum string length: 512
permissions
object

Response

Folder created successfully

id
integer<int32>
required

Unique identifier of the folder

name
string
required

Name of the folder

description
string

Description of the folder

parent_folder_id
integer<int32>

ID of the parent folder

permissions
object