Skip to main content
GET
Get folder by ID
Retrieves a folder’s details by its ID — name, description, parent folder, and the permission grants on it.
For ACB deployments updated from a version prior to 1.2, switch to the https://{hostname}/EkranACB server in the Playground.

Where to get the Folder ID

The Folder ID is visible on the Automation tab of the Edit Folder page — see Find the Folder ID.

Permissions required

The user owning the Access Token must have at least PAM User role on the folder.

Errors

See Status codes. Common errors:
  • 401 Unauthorized — expired Access Token.
  • 403 Forbidden — user lacks at least PAM User role on this folder.
  • 404 Not Found — folder doesn’t exist or isn’t visible.

Add folder

Create a new folder.

Update folder

Modify an existing folder.

Delete folder

Remove a folder.

Data models

FolderResponseDto and related schemas.

Authorizations

Authorization
string
header
required

Access token for authentication

Path Parameters

id
integer<int32>
required

The ID of the folder to retrieve

Required range: x >= 1

Response

Folder retrieved 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