Skip to main content
GET
/
serve
/
api
/
v1
/
list_unique_ids
List Unique IDs
curl --request GET \
  --url https://api.memories.ai/serve/api/v1/list_unique_ids \
  --header 'Authorization: <api-key>'
{
  "code": "0000",
  "msg": "success",
  "data": {
    "unique_ids": [
      "default",
      "holiday_2025",
      "project_alpha"
    ]
  },
  "success": true,
  "failed": false
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)
List all namespace partition keys (unique_id values) that exist under your account. A unique_id is more than a folder — it is a partition key that can represent an end-user, a customer tenant, a project, or any logical boundary in your data model. This endpoint shows every namespace that has been created so far.

​
Prerequisites

  • You have created a memories.ai API key.
  • You have uploaded at least one video under any unique_id — a namespace is created automatically on first upload and shows up here.

​
Endpoint

GET /serve/api/v1/list_unique_ids

​
Authentication

Pass your API key in the Authorization request header. The account is resolved from the API key — no query or body parameters are required. 
Authorization: sk-mavi-...

​
Request Example

import requests

url = "https://api.memories.ai/serve/api/v1/list_unique_ids"
headers = {"Authorization": "sk-mavi-..."}

response = requests.get(url, headers=headers)
print(response.json())

​
Query Parameters

None.

​
Notes & Limits

  • Rate limiting: The endpoint is protected by a per-account rate limit. Exceeding the limit returns an error indicating the request has exceeded the limit.
  • Scope of results: Returns every namespace that has been created under the authenticated account, including default once it has been used.
  • Case-sensitive deduplication: Entries are deduplicated by exact string match — LUCI, luci, and Luci are three distinct namespaces and all appear if they exist.
  • No pagination: The entire list is returned in one response. Active accounts can accumulate hundreds of namespaces; budget your UI accordingly.
  • Empty account: If no uploads have ever been made under this account, data.unique_ids is an empty array.

​
Response Example

{
    "code": "0000",
    "msg": "success",
    "data": {
        "unique_ids": [
            "default",
            "holiday_2025",
            "project_alpha"
        ]
    },
    "success": true,
    "failed": false
}

​
Response Fields

​
code
string
Business status code. 0000 indicates success.
​
msg
string
Human-readable status message.
​
data.unique_ids
array
Array of unique_id scope names belonging to the authenticated account. Each entry can be used as the unique_id parameter for other endpoints (upload, list_videos, get_metadata, search, chat, etc.). Deduplicated by exact string match (case-sensitive) and never contains empty strings.
​
success
boolean
Convenience flag — true when code == "0000".
​
failed
boolean
Convenience flag — inverse of success.

Authorizations

​
Authorization
string
header
required

Response

200 - application/json

Successful response

​
code
string
Example:

"0000"

​
msg
string
Example:

"success"

​
data
object
​
success
boolean
Example:

true

​
failed
boolean
Example:

false