Skip to content

List folders

GET
/folders
curl --request GET \
--url https://api.engram.page/folders \
--header 'Authorization: Bearer <token>'

Returns every folder in the current vault with its note count, plus a stable marker id and parent id so clients can rebuild the folder hierarchy. Derived (no-marker) folders and the root return a null id and are not eligible as parents.

Folders

Media typeapplication/json
FoldersResponse
object
folders
required
Array<object>
Folder
object
count
integer
id
string format: uuid
nullable
name
required
string
parent_id
string format: uuid
nullable
Examplegenerated
{
"folders": [
{
"count": 1,
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example",
"parent_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
]
}