Rename or move a folder
You're viewing API version
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.PATCH
Rename a folder (name) and/or move it under another parent (parentFolderId). Pass parentFolderId: null to move to top-level.
header
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-Key?stringMakes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
Length
length <= 255Body
application/json- body
name?stringRename the folder
Length
1 <= lengthparentFolderId?|Move the folder. Pass null to move to top-level.
200
application/json- response
id*stringUnique folder identifier
name*stringFolder name
type*stringFolder type: DOCUMENT or TEMPLATE
Value in
"DOCUMENT""TEMPLATE"parentFolderId*|Parent folder id, or null for top-level folders
workspaceId*stringcreatedById*stringcreatedAt*unknownupdatedAt*unknownchildFolderCount?integerNumber of direct child folders (non-deleted)
Range
-9007199254740991 <= value <= 9007199254740991itemCount?integerNumber of documents or templates directly in this folder
Range
-9007199254740991 <= value <= 9007199254740991curl -X PATCH 'https://app.sajn.se/api/v1/folders/string' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "id": "string", "name": "string", "type": "DOCUMENT", "parentFolderId": "string", "workspaceId": "string", "createdById": "string", "createdAt": null, "updatedAt": null, "childFolderCount": -9007199254740991, "itemCount": -9007199254740991}Was this page helpful?