List Doc Folders
List all active folders used to organize workspace docs. Folders are returned as a flat list with parentId references; clients reconstruct the tree as needed.
GET
/api/v1/docs/foldersAuthorization
ApiKeyAuth Query Parameters
workspaceId*string
The unique identifier of the workspace.
limit?integer
Page size (1-200). Omit both limit and cursor to receive every folder in one response; when only cursor is sent the page size defaults to 100.
Range
1 <= value <= 200cursor?string
Pagination cursor returned in a previous response's nextCursor field.
Response Body
application/json
curl -X GET "https://example.com/api/v1/docs/folders?workspaceId=string"{ "success": true, "data": { "folders": [ { "id": "string", "workspaceId": "string", "parentId": "string", "name": "string", "isSystem": true, "sortOrder": 0, "color": "string", "createdBy": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ], "totalCount": 0 }, "nextCursor": "string", "limits": { "workflowExecutionRateLimit": { "sync": { "requestsPerMinute": 0, "maxBurst": 0, "remaining": 0, "resetAt": "2019-08-24T14:15:22Z" }, "async": { "requestsPerMinute": 0, "maxBurst": 0, "remaining": 0, "resetAt": "2019-08-24T14:15:22Z" } }, "usage": { "currentPeriodCost": 0, "limit": 0, "plan": "string", "isExceeded": true } }}