generated: '2026-07-20'
method: searched
source: https://api-tools.memories.ai/
authentication:
  style: api-key
  location: header
  header: Authorization
  key_prefix: sk-mavi-
  ref: authentication/memories-authentication.yml
base_urls:
  visual_search_v1: https://api.memories.ai/serve/api/v1
  visual_intelligence_v2: https://mavi-backend.memories.ai/serve/api/v2
  stream_understanding: https://stream.memories.ai
versioning:
  scheme: uri-path
  versions: [v1, v2]
  note: >-
    v1 = Visual Search (managed hosting + search library); v2 = Visual
    Intelligence (stateless atomic analysis). No dated version header.
error_envelope:
  shape: '{code, msg, data, success, failed}'
  success_code: '0000'
  ref: errors/memories-error-codes.yml
async:
  model: task-id
  note: >-
    Long-running operations return a task_id immediately; poll get_task_status
    or receive results via webhook callback.
  webhooks_ref: asyncapi/memories-webhooks.yml
pagination:
  style: page-based
  note: >-
    List endpoints (list_videos, list_folder_videos) accept page/size-style
    parameters and return paginated results.
idempotency:
  supported: false
  note: >-
    No client idempotency-key header is documented. Error code 0409 guards
    against repeated non-repeatable operations server-side, but there is no
    caller-supplied idempotency contract.
rate_limiting:
  ref: rate-limits/memories-rate-limits.yml
  signal: HTTP 200 with envelope code 0429 (or code 429) on limit exceeded