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.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe folder ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-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 <= 255Body
application/json- body
name?stringRename the folder
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
"DOCUMENT""TEMPLATE"parentFolderId*|Parent folder id, or null for top-level folders
workspaceId*stringThe workspace ID.
createdBy*The user who created the folder
createdAt*stringWhen the folder was created.
date-timeupdatedAt*stringWhen the folder was last updated.
date-timechildFolderCount*integerNumber of folders directly in this folder, not counting trashed ones
-9007199254740991 <= value <= 9007199254740991itemCount*integerNumber of documents or templates directly in this folder that you can see, not counting trashed or archived ones
-9007199254740991 <= value <= 9007199254740991curl -X PATCH 'https://app.sajn.se/api/v1/folders/cm4k2x9p10011abcd1234efgh' \ -H 'Content-Type: application/json' \ -d '{ "name": "Anställningsavtal 2026", "parentFolderId": null}'{ "id": "cm4k2x9p10011abcd1234efgh", "name": "Anställningsavtal 2026", "type": "DOCUMENT", "parentFolderId": null, "workspaceId": "cm4k2x9p10001abcd1234efgh", "createdBy": { "id": "cm4k2x9p10002abcd1234efgh", "email": "alex@example.com", "name": "Alex Berg" }, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z", "childFolderCount": 0, "itemCount": 12}Was this page helpful?