List Folders
Folder Management
List Folders
List all folders in your account, used to organize your Private Video Library.
GET
List Folders
Product: Visual Search
Use case: Organize your indexed videos into folders and scope uploads/searches to a folder
Host:
https://api.memories.ai/serve/api/v1
Auth: Authorization: sk-mavi-... (no Bearer prefix)folder_id, and list/search can be scoped to one.
Your account always has a built-in Default folder (folder_id -1), created automatically on first upload. If any videos were imported through the legacy /api/video endpoint, a read-only API folder (folder_id -2) is also returned.
Prerequisites
- You have created a memories.ai API key.
Request Example
cURL
Response Example
Response Fields
Business status code.
0000 indicates success.Human-readable status message.
All folders belonging to the authenticated account.
Folder identifier. Pass it as
folder_id on upload/list/search. -1 is the Default folder; -2 (if present) is the read-only legacy API folder.Folder display name.
Notes & Limits
- Rate limiting: Folder endpoints share a per-account rate limit. See Rate limits.
- The Default folder is created on demand — a brand-new account with no uploads may show it only after the first list/upload.
