# Memories.ai API

## Docs

- [Video Datalake](https://docs.memories.ai/overview.md): A searchable, AI-indexed video data lake — ingest video and live streams, then search and read any moment over one REST API.
- [Quickstart](https://docs.memories.ai/datalake/quickstart.md): Create a collection, upload a video, wait for indexing, and read the results — in five minutes.
- [Authentication](https://docs.memories.ai/authentication.md): API key, host, and request conventions for the Video Datalake.
- [Core Concepts](https://docs.memories.ai/datalake/core-concepts.md): Collections, videos, the async Operation model, moments, and derived content — the mental model behind every endpoint.
- [Create Collection](https://docs.memories.ai/datalake/collections/create-collection.md): Create a collection
- [List Collections](https://docs.memories.ai/datalake/collections/list-collections.md): List collections
- [Get Collection](https://docs.memories.ai/datalake/collections/get-collection.md): Get a collection
- [Update Collection](https://docs.memories.ai/datalake/collections/update-collection.md): Update a collection
- [Delete Collection](https://docs.memories.ai/datalake/collections/delete-collection.md): Delete a collection
- [Upload Video — from URL](https://docs.memories.ai/datalake/videos/upload-video-url.md): Upload a video by URL
- [Upload Video — from File](https://docs.memories.ai/datalake/videos/upload-video-file.md): Upload a video file (multipart)
- [Upload Video — Resumable](https://docs.memories.ai/datalake/videos/upload-video-resumable.md): Start a resumable upload session
- [Finalize Resumable Upload](https://docs.memories.ai/datalake/videos/finalize-upload.md): Confirm a resumable upload is complete
- [List Videos](https://docs.memories.ai/datalake/videos/list-videos.md): List videos in a collection
- [Get Video](https://docs.memories.ai/datalake/videos/get-video.md): Get a video
- [Update Video](https://docs.memories.ai/datalake/videos/update-video.md): Update video metadata
- [Delete Video](https://docs.memories.ai/datalake/videos/delete-video.md): Delete a video
- [Move Video](https://docs.memories.ai/datalake/videos/move-video.md): Move a video to another collection
- [Get Operation](https://docs.memories.ai/datalake/operations/get-operation.md): Poll an async operation
- [Cancel Operation](https://docs.memories.ai/datalake/operations/cancel-operation.md): Cancel an ingest operation
- [List Webhook Deliveries](https://docs.memories.ai/datalake/operations/list-deliveries.md): Inspect webhook delivery attempts
- [Get Balance](https://docs.memories.ai/datalake/operations/get-balance.md): Get account balance
- [Get Moment](https://docs.memories.ai/datalake/moments/get-moment.md): Get a time-slice aggregate view
- [Get Frame](https://docs.memories.ai/datalake/moments/get-frame.md): Get the nearest sampled frame
- [Get Clip](https://docs.memories.ai/datalake/moments/get-clip.md): Cut a clip for a time range
- [Get Caption](https://docs.memories.ai/datalake/moments/get-caption.md): Get visual captions (4 modes)
- [Get Transcription](https://docs.memories.ai/datalake/moments/get-transcription.md): Get audio transcription (4 modes)
- [Get Title](https://docs.memories.ai/datalake/moments/get-title.md): Get the AI title
- [Get Summary](https://docs.memories.ai/datalake/moments/get-summary.md): Get the AI summary
- [Get Speakers](https://docs.memories.ai/datalake/moments/get-speakers.md): Get diarized speakers
- [Get Face Entities](https://docs.memories.ai/datalake/moments/get-entities.md): Get detected face entities
- [Get Video Events](https://docs.memories.ai/datalake/events/get-video-events.md): Get safety events for one video
- [List Collection Events](https://docs.memories.ai/datalake/events/list-events.md): List safety events across a collection
- [Get Event](https://docs.memories.ai/datalake/events/get-event.md): Get one event
- [Create Person](https://docs.memories.ai/datalake/persons/create-person.md): Build a person from reference faces
- [List Persons](https://docs.memories.ai/datalake/persons/list-persons.md): List persons
- [Get Person](https://docs.memories.ai/datalake/persons/get-person.md): Get a person
- [Update Person](https://docs.memories.ai/datalake/persons/update-person.md): Update a person
- [Delete Person](https://docs.memories.ai/datalake/persons/delete-person.md): Soft-delete a person
- [Add Person Faces](https://docs.memories.ai/datalake/persons/add-person-faces.md): Append reference faces (202)
- [Search Moments](https://docs.memories.ai/datalake/search/search.md): Search collection content (semantic / keyword / image)
- [Upload Search Image](https://docs.memories.ai/datalake/search/upload-search-image.md): Upload an image for image-search
- [Open Stream](https://docs.memories.ai/datalake/streams/open-stream.md): Open a live stream session
- [Close Stream](https://docs.memories.ai/datalake/streams/close-stream.md): Close and finalize a stream
- [Subscribe (SSE)](https://docs.memories.ai/datalake/streams/subscribe.md): Subscribe to live derived data (Server-Sent Events)
- [Video Agent](https://docs.memories.ai/video-agent.md): Build an agent that operates the Video Datalake in natural language — with the lake as its long-term video memory.
- [MCP Server](https://docs.memories.ai/mcp-server.md): Connect any MCP-compatible agent to the Video Datalake — the official MCP server.
- [Plugin](https://docs.memories.ai/plugin.md): The Memories plugin for Claude Code and Codex — skills, commands, and the hosted MCP server.
- [CLI](https://docs.memories.ai/cli.md): The memories CLI — a JSON-first command-line client for the Memories.ai API.
- [FAQ](https://docs.memories.ai/faq.md): Common questions about video sources, processing time, throughput, formats, and limits.
- [Errors & Rate Limits](https://docs.memories.ai/reference/errors-and-rate-limits.md): Error response shape, status codes, rate limits, and quotas for the Video Datalake.
- [Webhooks](https://docs.memories.ai/datalake/reference/webhooks.md): How completion callbacks are delivered, signed, and retried.
- [Pricing](https://docs.memories.ai/datalake/pricing.md): Pay-as-you-go, per-API pricing for the Video Datalake — management and reads are free; you pay for indexing, search, media, and storage.
- [Changelog](https://docs.memories.ai/changelog.md): New features, endpoints, and changes to the Video Datalake API.

## OpenAPI Specs

- [openapi](https://docs.memories.ai/datalake/openapi.json)
- [understanding-openapi](https://docs.memories.ai/visual-intelligence/stream/understanding-openapi.json)