API ReferenceVault
Vault index status
Returns indexed folder/item/tagged counts, the last-indexed time, and whether a scan is currently running. 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
Response Body
application/json
application/json
curl -X GET "https://example.com/api/admin/vault/scan/status"{ "folders": 42, "items": 3187, "tagged": 2904, "last_indexed_at": 1751290000, "running": false}{ "detail": "Not authenticated"}List all media ids in a folder
Returns every media id in one folder/album so the whole pack can be selected at once. Requires a read-scoped key.
Trigger a vault re-index
Starts a background (re)index of the vault. Returns started=false with already_running=true when a scan is already in flight. Requires a write-scoped key.