API ReferenceVault
Search the AI-tagged vault index
Instant title/tag search over the vault index, returning vault media grouped by folder plus loose (un-foldered) items. Requires a read-scoped key.
Authorization
bearerAuth AuthorizationBearer <token>
Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.
In: header
Query Parameters
q?string
Search text matched against media title/tags.
Default
""scope?string
Filter scope (e.g. all / sorted / unsorted). Defaults to all.
Default
"all"limit?integer
Maximum media items to return.
Range
1 <= value <= 1000Default
200Response Body
application/json
application/json
curl -X GET "https://example.com/api/admin/vault/search"{ "folders": [ { "folder_id": "f_8842", "name": "Beach set 07", "items": [ { "media_id": "501", "title": "beach sunset", "media_type": "photo", "has_cover": true } ] } ], "loose": [ { "media_id": "733", "title": "untitled clip", "media_type": "video", "has_cover": false } ]}{ "detail": "Not authenticated"}