List folders

View as Markdown

Returns the project’s folders as a flat list (the caller builds the tree). When parentId is given, returns only that level (root for top-level). Requires file:read on the project.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired

Query parameters

parentIdstringOptional

Response

The project's folders.
folderslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error