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/folders

Authorization

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.

Range1 <= value <= 200
cursor?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    }  }}