List folders
List all folders for the authenticated user. Each folder carries the sessions the user has organized into it in the Wave app. Folders are non-exclusive — a session can belong to many folders at once. Use the folder id or name with GET /v1/sessions?folder=… to restrict a session list to one folder. Requires the folders:read scope; sessions:read is also accepted for backward compatibility. created_at / updated_at and the preferences pinned / sort_order / order / last_opened_at are included when present; absence means the default (not pinned, newest first, no manual position, never opened). Folders are returned in display order: pinned first, then order ascending (folders with an order before those without), then name.
Request
- Base URL: https://api.wave.co
- URL: https://api.wave.co/v1/folders
- Auth: HTTP bearer
Response
Folder list
Example response
{
"folders": [
{
"id": "fld_01HX4R7MT8PQZ6VCN9ABYF2KJM",
"name": "work",
"color": "#6D28D9",
"session_count": 82,
"created_at": "2026-09-01T14:02:11.000Z",
"updated_at": "2026-09-05T09:41:37.000Z",
"pinned": true,
"sort_order": "newest",
"order": 0,
"last_opened_at": "2026-09-06T08:15:02.000Z"
},
{
"id": "fld_01HX5S8NV9QR0XDJ2KBC7ZG3HT",
"name": "personal",
"color": "#F59E0B",
"session_count": 14,
"created_at": "2026-08-12T18:30:00.000Z",
"updated_at": "2026-08-12T18:30:00.000Z"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.