Skip to main content
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)
List every folder in your account. Folders organize your Private Video Library; each upload can target a folder via 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

Request Example

cURL

Response Example

Response Fields

code
string
Business status code. 0000 indicates success.
msg
string
Human-readable status message.
data.folders
array
All folders belonging to the authenticated account.
data.folders[].folder_id
integer
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.
data.folders[].folder_name
string
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.

Authorizations

Authorization
string
header
required

Response

200 - application/json

Successful response

code
string
Example:

"0000"

msg
string
Example:

"success"

data
object