Rename or move a folder

Rename a folder (name) and/or move it under another parent (parentFolderId). Pass parentFolderId: null to move to top-level.

PATCH /api/v1/folders/{id}

Rename or move a folder

cURL

curl --request PATCH \
  --url https://app.sajn.se/api/v1/folders/{id} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "parentFolderId": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "parentFolderId": "<string>",
  "workspaceId": "<string>",
  "createdById": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "childFolderCount": 0,
  "itemCount": 0
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Body

application/json

Body

name · string

Rename the folder

Minimum string length: 1

parentFolderId · string | null

Move the folder. Pass null to move to top-level.

Response

200

application/json

200

id · string · required

Unique folder identifier

name · string · required

Folder name

type · enum<string> · required

Folder type: DOCUMENT or TEMPLATE

Available options: DOCUMENT, TEMPLATE

parentFolderId · string | null · required

Parent folder id, or null for top-level folders

workspaceId · string · required

createdById · string · required

createdAt · any · required

updatedAt · any · required

childFolderCount · integer

Number of direct child folders (non-deleted)

Required range: -9007199254740991 <= x <= 9007199254740991

itemCount · integer

Number of documents or templates directly in this folder

Required range: -9007199254740991 <= x <= 9007199254740991