List folders
List folders in the current workspace, optionally filtered by type (DOCUMENT or TEMPLATE) and parent folder.
Pass parentFolderId to list direct children of a specific folder. Omit it to list top-level folders. The newest folders come first.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
limit?integerMaximum number of items to return, from 1 to 100. Default: 25.
1 <= value <= 10025cursor?stringThe nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.
1 <= length <= 2048include?array<>total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.
type?stringReturn only DOCUMENT or TEMPLATE folders. Omit for both.
"DOCUMENT""TEMPLATE"parentFolderId?stringReturn only folders directly under this parent. Omit for top-level folders.
createdAfter?stringOnly folders created at or after this ISO 8601 date or date-time.
createdBefore?stringOnly folders created at or before this ISO 8601 date or date-time.
updatedAfter?stringOnly folders updated at or after this ISO 8601 date or date-time. Use it for incremental sync.
updatedBefore?stringOnly folders updated at or before this ISO 8601 date or date-time.
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.
List of folders
application/json- response
List of folders
data*array<>hasMore*booleanTrue if more items follow this page.
nextCursor*|Pass this as cursor to get the next page. Null on the last page.
total?integerThe number of items that match the filters. Present only with include=total.
-9007199254740991 <= value <= 9007199254740991curl -X GET 'https://app.sajn.se/api/v1/folders'{ "data": [ { "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 } ], "hasMore": false, "nextCursor": null, "total": 1}Was this page helpful?