List folders the token can see.
Returns folders in the token's scope. Unscoped tokens get the user's full folder list; scoped tokens get only the folders they were minted against. Each row includes item_count. Per-token rate limit: 1000/hr.
Returns folders in the token's scope. Unscoped tokens get the user's full folder list; scoped tokens get only the folders they were minted against. Each row includes item_count. Per-token rate limit: 1000/hr.
Authorization
bearerAuth Per-user bearer token minted at /settings/integrations. Format: 'lev_' followed by 32 base64url chars. Each token carries a capability set (read | write) and a folder scope (whole library or a list of specific folders). Per-endpoint requirements are noted on each operation.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/folders"{
"folders": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"created_at": "2019-08-24T14:15:22Z",
"last_added_at": "2019-08-24T14:15:22Z",
"item_count": 0
}
]
}{
"error": "string",
"message": "string"
}{
"error": "rate_limited",
"retry_after_sec": 0
}Delete a folder. DELETE
Whole-library tokens only. By default the items in the folder survive (their other folder memberships are preserved; items whose ONLY folder was this one become unfiled). Pass ?cascade_items=true to also delete items whose only folder is this one. Folder_items + kb_access_token_folders rows cascade automatically via FK CASCADE; tokens whose last scoped folder gets deleted are auto-revoked. Per-token rate limit: 30/hr.
Add the item to one or more folders. POST
Idempotent — re-adding an existing (folder, item) pair is silently absorbed. Single-folder scope tokens get 403 forbidden_scope (no destination to add TO). Multi-folder scope tokens require every target folder to be in scope; out-of-scope targets surface as 403 with the offending ids. Per-token rate limit: 60/hr.