Delete an item.
Write capability. Scoped tokens require ≥1 in-scope folder membership; out-of-scope returns 404. Cascade is automatic: outputs / chunks / folder_items via FK CASCADE; manual-upload storage objects queued by the delete_orphan_manual_content trigger for the 30-min cron drainer. Per-token rate limit: 30/hr.
Write capability. Scoped tokens require ≥1 in-scope folder membership; out-of-scope returns 404. Cascade is automatic: outputs / chunks / folder_items via FK CASCADE; manual-upload storage objects queued by the delete_orphan_manual_content trigger for the 30-min cron drainer. Per-token rate limit: 30/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
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/items/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"ok": true
}{
"error": "string",
"message": "string"
}{
"error": "string",
"message": "string"
}{
"error": "string",
"message": "string"
}{
"error": "rate_limited",
"retry_after_sec": 0
}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.
Get full item. GET
Returns metadata, transcript + segments, outputs (transforms), and folder memberships (filtered to in-scope folders only). Scoped tokens 404 on items outside scope; kbOnly tokens 404 on in_kb=false items. Per-token rate limit: 1000/hr.