# Refmatter

> Reference memory for AI creative agents: turn a public video URL into a durable, provenance-backed reference through a REST API, a TypeScript SDK, and MCP.

- [What Refmatter is](https://docs.refmatter.com/index.md): Reference memory for AI creative agents: a public video URL in, a durable reference with verified media and provenance out.
- [Quickstart](https://docs.refmatter.com/quickstart.md): Create your first reference from a YouTube URL.
- [Authentication](https://docs.refmatter.com/guides/authentication.md): Workspace API keys for machines, sessions for people. Never both on one request.
- [References](https://docs.refmatter.com/concepts/references.md): One object per acquired source, with observed, derived, and human-authored fields kept apart.
- [Media retention](https://docs.refmatter.com/concepts/media-retention.md): Derivatives are durable; media bytes exist only under a time-boxed hold you control.
- [Sources](https://docs.refmatter.com/concepts/sources.md): What Refmatter can acquire today, what is planned, and what it will never pretend to do.
- [Ingest a URL](https://docs.refmatter.com/guides/ingest-a-url.md): Idempotent submission, progress, cancellation, and what success and failure look like.
- [Browse and annotate](https://docs.refmatter.com/guides/browse-and-annotate.md): List the catalog, page with cursors, and add human notes without fighting refreshes.
- [Transcripts](https://docs.refmatter.com/guides/transcripts.md): Timed text from the source's captions, stored with the reference and kept after the media expires.
- [Media access](https://docs.refmatter.com/guides/media-access.md): Short-lived download URLs for the primary video and the poster frame.
- [Errors](https://docs.refmatter.com/guides/errors.md): One envelope, a stable code vocabulary, and a retryable flag you can act on.
- [TypeScript SDK](https://docs.refmatter.com/sdk/typescript.md): @refmatter/sdk is generated from the API contract, so it cannot drift from the server.
- [MCP server](https://docs.refmatter.com/mcp/overview.md): Expose your Refmatter workspace to Claude, Cursor, or any MCP client with one URL and your API key.
- [Retention and takedown](https://docs.refmatter.com/policies/retention-and-takedown.md): What we store, for how long, and how a rights holder gets content removed.
- [API overview](https://docs.refmatter.com/api-reference/introduction.md): Base URL, versioning, authentication, and conventions shared by every endpoint.
- [Accept one source URL for durable ingestion](https://docs.refmatter.com/api-reference/ingestions/accept-one-source-url-for-durable-ingestion.md)
- [Read ingestion progress and outcome](https://docs.refmatter.com/api-reference/ingestions/read-ingestion-progress-and-outcome.md)
- [Request cooperative ingestion cancellation](https://docs.refmatter.com/api-reference/ingestions/request-cooperative-ingestion-cancellation.md)
- [Create a bounded human session](https://docs.refmatter.com/api-reference/auth/create-a-bounded-human-session.md)
- [Read the current human session](https://docs.refmatter.com/api-reference/auth/read-the-current-human-session.md)
- [Revoke the current human session](https://docs.refmatter.com/api-reference/auth/revoke-the-current-human-session.md)
- [List active workspaces available to the current user](https://docs.refmatter.com/api-reference/workspaces/list-active-workspaces-available-to-the-current-user.md)
- [List safe workspace API key metadata](https://docs.refmatter.com/api-reference/workspaces/list-safe-workspace-api-key-metadata.md)
- [Create a scoped workspace API key](https://docs.refmatter.com/api-reference/workspaces/create-a-scoped-workspace-api-key.md)
- [Immediately revoke a workspace API key](https://docs.refmatter.com/api-reference/workspaces/immediately-revoke-a-workspace-api-key.md)
- [List workspace references using opaque keyset pagination](https://docs.refmatter.com/api-reference/references/list-workspace-references-using-opaque-keyset-pagination.md)
- [Read a workspace reference](https://docs.refmatter.com/api-reference/references/read-a-workspace-reference.md)
- [Delete a workspace reference](https://docs.refmatter.com/api-reference/references/delete-a-workspace-reference.md)
- [Update human-authored reference fields](https://docs.refmatter.com/api-reference/references/update-human-authored-reference-fields.md)
- [Read the transcript derived from the source captions](https://docs.refmatter.com/api-reference/references/read-the-transcript-derived-from-the-source-captions.md)
- [Create or extend the time-boxed hold that keeps committed media bytes](https://docs.refmatter.com/api-reference/references/create-or-extend-the-time-boxed-hold-that-keeps-committed-media-bytes.md)
- [Release the media hold so bytes expire at the next retention pass](https://docs.refmatter.com/api-reference/references/release-the-media-hold-so-bytes-expire-at-the-next-retention-pass.md)
- [Create short-lived authorized media access](https://docs.refmatter.com/api-reference/media/create-short-lived-authorized-media-access.md)
- [Discover customer-visible source support and limits](https://docs.refmatter.com/api-reference/sourceroutes/discover-customer-visible-source-support-and-limits.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)