Skip to content

Get the whole vault tree in one read

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

Every folder, note and attachment the file tree renders, in one response.

Vault tree

Media typeapplication/json
VaultTreeResponse
object
attachments
Array<object>
VaultTreeAttachment
object
id
required
string format: uuid
mime_type
string
nullable
mtime
required

Client mtime (epoch seconds)

number format: float
path
required
string
size_bytes
required
integer
updated_at
required
string format: date-time
change_seq
required

Current per-vault sequence watermark.

integer
folders
Array<object>
Folder
object
count
integer
id
string format: uuid
nullable
name
required
string
parent_id
string format: uuid
nullable
notes
Array<object>
VaultTreeNote
object
created_at
required
string format: date-time
id
required
string format: uuid
path
required
string
updated_at
required
string format: date-time
Examplegenerated
{
"attachments": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"mime_type": "example",
"mtime": 1,
"path": "example",
"size_bytes": 1,
"updated_at": "2026-04-15T12:00:00Z"
}
],
"change_seq": 1,
"folders": [
{
"count": 1,
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example",
"parent_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
],
"notes": [
{
"created_at": "2026-04-15T12:00:00Z",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"path": "example",
"updated_at": "2026-04-15T12:00:00Z"
}
]
}