-
Type:
Suggestion
-
Resolution: Unresolved
-
Component/s: User - API
Issue Summary
The Confluence V2 REST API's Folder section is missing endpoints to list and traverse folder hierarchies within a space. Currently, only 3 operations are available: Create Folder, Get Folder by ID, and Delete Folder. There is no way to list all folders in a space or retrieve a folder tree structure.
Steps to Reproduce
- Have a Confluence space with a folder hierarchy (nested folders containing pages).
- Attempt to retrieve the full list of folders in the space using the V2 REST API.
- Attempt to traverse or replicate the folder tree structure programmatically.
Expected Results
The API should provide endpoints equivalent to what exists for pages, such as:
- GET /wiki/api/v2/spaces/{spaceId}/folders — to list all folders in a space.
- GET /wiki/api/v2/folders/{folderId}/children — to retrieve child folders/pages within a folder.
This would allow developers to fully replicate a space's folder hierarchy programmatically (e.g., for space copying, migration, or automation workflows).
Actual Results
No endpoint exists to list folders in a space or traverse the folder tree. Developers cannot programmatically discover folder IDs or structure without prior knowledge. This makes it impossible to fully copy or recreate a space that contains folders using the REST API alone.
Workaround
Use GET /wiki/api/v2/spaces/{spaceId}/pages and filter for pages where parentType: "folder" to infer folder membership indirectly. However, this does not provide the folder list itself, and folder IDs still cannot be discovered without at least one known folder ID. This workaround is insufficient for full space replication scenarios.