DKBSignDocs

API reference

PUTRequires Bearer token

Update a folder

/api/edm/folders/{folder_id}

Update /api/edm/folders/{folder_id}. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

FieldTypeDescription
folder_id
Required
stringPath parameter folder_id.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
stringFolder name.
parent_id
stringParent folder UUID.
typology_id
stringDefault typology UUID.
tier_override
stringstandard, vault, or null.
inherit_access
booleanInherit parent permissions.
e.g. true

Responses

StatusMeaning
200Success
401Missing or invalid Bearer token.

Request

curl
curl -X PUT 'https://api.dkbsigns.com/api/edm/folders/uuid_or_id' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"example","parent_id":"uuid_or_id","typology_id":"uuid_or_id","tier_override":"example","inherit_access":true}'

Response 200

json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "1",
  "folder_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "typology_id": null,
  "name": "Contract 2026.pdf",
  "status": "draft",
  "size_bytes": 1048576,
  "mime_type": "application/pdf",
  "owner_user_id": "4",
  "metadata": {},
  "tags": [
    "client-x"
  ],
  "legal_hold": false,
  "version_count": 1,
  "sealed_at": null,
  "created_at": "2026-03-01T10:00:00Z",
  "updated_at": "2026-03-01T10:00:00Z"
}