Skip to main content
PATCH
Update folder
Updates a folder. This is a partial update (PATCH semantics) — only fields included in the request body are changed; omitted fields are left unchanged.
For ACB deployments updated from a version prior to 1.2, switch to the https://{hostname}/EkranACB server in the Playground.

Permissions required

  • Editor or Owner role on the folder for most field changes.
  • Owner role required to modify the permissions field.

Errors

See Status codes. Common errors:
  • 403 Forbidden — user lacks Editor/Owner role (or lacks Owner when modifying permissions).
  • 404 Not Found — folder doesn’t exist.
  • 409 Conflict — renaming to a name that already exists in the parent.

Get folder

Read current folder state.

Add folder

Create a new folder.

Delete folder

Remove a folder.

Data models

FolderResponseDto schema.

Authorizations

Authorization
string
header
required

Access token for authentication

Path Parameters

id
integer<int32>
required

The ID of the folder to update

Required range: x >= 1

Body

application/json
name
string

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 updated 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