# Versuno Docs

## Docs

- [Overview](https://docs.versuno.ai/index.md): Create, version, and serve the prompts your AI runs on, and query the brains it learns from. Universal memory for AI is on the way.
- [API Guide](https://docs.versuno.ai/api-guide.md): Authentication, quick start examples, error handling, and key endpoints for the Versuno Public API.
- [MCP vs CLI](https://docs.versuno.ai/mcp-vs-cli.md): Choosing between the Versuno MCP server and the Versuno CLI.
- [Overview](https://docs.versuno.ai/memory/overview.md): Your private memory brain, the one place every AI agent reads from and writes to.
- [Memory types](https://docs.versuno.ai/memory/memory-types.md): The four kinds of memory: fact, preference, episode, and procedure.
- [Overview](https://docs.versuno.ai/brains/overview.md): A brain is a graph-based knowledge structure you can read and query over the API.
- [Architecture](https://docs.versuno.ai/brains/architecture.md): How public brains are structured, secured, and queried.
- [Prompt](https://docs.versuno.ai/asset-types/prompt.md): Task-oriented instructions for a single AI interaction.
- [Persona](https://docs.versuno.ai/asset-types/persona.md): AI personalities and behavioral guidelines for consistent identity.
- [Context](https://docs.versuno.ai/asset-types/context.md): Knowledge base and reference material for AI agents.
- [System Prompt](https://docs.versuno.ai/asset-types/system-prompt.md): Foundation-level instructions that govern AI behavior for an entire session.
- [Skill](https://docs.versuno.ai/asset-types/skill.md): Reusable capability packages for AI agents.
- [Editor Overview](https://docs.versuno.ai/editor/overview.md): The Versuno editor is a rich-text, block-based editor built for writing and structuring AI asset content.
- [Blocks](https://docs.versuno.ai/editor/blocks.md): Every piece of content in the Versuno editor is a block. Insert any block with the / slash command or by typing a Markdown shortcut.
- [Text Formatting](https://docs.versuno.ai/editor/formatting.md): Select text to open the floating toolbar and apply inline formatting, links, and block conversions.
- [Keyboard Shortcuts](https://docs.versuno.ai/editor/keyboard-shortcuts.md): Complete reference for every keyboard shortcut in the Versuno editor.
- [Verify API key](https://docs.versuno.ai/api-reference/authentication/verify-api-key.md): Validates the API key supplied in the `Authorization` header and returns the caller's identity. Use this as the first call in any CLI or integration to confirm the key is valid and retrieve the user it belongs to.
- [Create agent identity](https://docs.versuno.ai/api-reference/authentication/create-agent-identity.md): Creates a Free-tier account and API key for an AI agent with no email inbox. Returns an `api_key` usable immediately and a `claim_url` the agent should report back to its human to make the account permanent. No authentication required.
- [Claim agent identity](https://docs.versuno.ai/api-reference/authentication/claim-agent-identity.md): Attaches a real email address and password to an agent identity and sends a verification email. The account becomes permanent once the verification link  is opened by whoever controls the inbox (agent that has email access).
- [Sync captured agent memory](https://docs.versuno.ai/api-reference/memory/sync-captured-agent-memory.md): Capture-only upload of an agent's parsed memory. The server DIFFs each memory against prior captures by `content_hash`, embeds the new/changed ones, upserts them, then runs the dedup + contradiction funnel. Identical memories merge onto the existing belief; contradictions (and low-confidence matches…
- [Save a memory](https://docs.versuno.ai/api-reference/memory/save-a-memory.md): An agent or app writes one durable memory straight to the private brain. It runs the same dedup funnel as capture: an identical memory merges, a contradiction comes back as a conflict for the user to resolve.
- [Recall memory](https://docs.versuno.ai/api-reference/memory/recall-memory.md): Semantic (RAG) search over your active memory, scoped to your API key. Returns the most relevant memories ranked by similarity, plus the structural edges between them. Stale (superseded, or no longer in any source) memories are excluded.
- [Resolve a memory conflict](https://docs.versuno.ai/api-reference/memory/resolve-a-memory-conflict.md): Apply a human decision to a contradiction surfaced by `/memory/sync`. Every action is non-destructive and reversible: the loser is marked stale with a `replaces` edge. Pass the `judgmentId` from the conflict so the decision is recorded against the judge call.
- [List my teams](https://docs.versuno.ai/api-reference/teams/list-my-teams.md): Returns all teams the authenticated user owns or is an active member of, ordered by ownership then join date.
- [List public brains](https://docs.versuno.ai/api-reference/public-brains/list-public-brains.md): Returns all brains marked as public. Anyone with a valid API key can read these.
- [Get a brain](https://docs.versuno.ai/api-reference/public-brains/get-a-brain.md): Returns a single brain by ID. You can read any public brain, plus any brain you own.
- [List containers](https://docs.versuno.ai/api-reference/public-brains/list-containers.md): Returns all containers in a brain as a flat array.
- [List containers (tree)](https://docs.versuno.ai/api-reference/public-brains/list-containers-tree.md): Returns the brain's containers as a nested tree, each carrying its `children`.
- [Get a container](https://docs.versuno.ai/api-reference/public-brains/get-a-container.md): Returns a single container by ID.
- [List nodes](https://docs.versuno.ai/api-reference/public-brains/list-nodes.md): Returns lightweight previews of the nodes in a container, as a flat array.
- [List nodes (tree)](https://docs.versuno.ai/api-reference/public-brains/list-nodes-tree.md): Returns node previews in a container as a nested tree, each carrying its `subNodes`.
- [Get a node](https://docs.versuno.ai/api-reference/public-brains/get-a-node.md): Returns a single node by ID, including its full content.
- [Query a brain](https://docs.versuno.ai/api-reference/public-brains/query-a-brain.md): Runs a semantic (RAG) search over a brain and returns the most relevant pages, chunks, and chunk parts, plus the graph relations between them.
- [Query a container](https://docs.versuno.ai/api-reference/public-brains/query-a-container.md): Same as [Query a brain](#tag/brains/post/brains/{id}/query), but scopes the semantic search to a single container within the brain.
- [List all assets](https://docs.versuno.ai/api-reference/assets/list-all-assets.md): Returns all non-trashed assets belonging to the authenticated user, ordered by `created_at` descending.
- [Create an asset](https://docs.versuno.ai/api-reference/assets/create-an-asset.md): Creates a new asset. The `assetType` determines which typed view is used.
- [Get a single asset](https://docs.versuno.ai/api-reference/assets/get-a-single-asset.md): Returns a single non-trashed asset. Omit `assetType` for base fields only; provide it for type-specific fields.
- [Update an asset](https://docs.versuno.ai/api-reference/assets/update-an-asset.md): Partially updates an asset. Send only the fields you want to change. An empty body returns `400`.
- [Get all blocks](https://docs.versuno.ai/api-reference/assets/get-all-blocks.md): Returns the full block tree for the target asset.
- [Patch specific blocks](https://docs.versuno.ai/api-reference/assets/patch-specific-blocks.md): Applies id-based partial updates to selected blocks without replacing the full block tree.
- [Create a block](https://docs.versuno.ai/api-reference/assets/create-a-block.md): Creates a new block in an asset at root level or under a parent block.
- [Apply block operations](https://docs.versuno.ai/api-reference/assets/apply-block-operations.md): Applies structural block transforms using the unified turn_into command.
- [Get a block](https://docs.versuno.ai/api-reference/assets/get-a-block.md): Returns a single block by ID from the target asset.
- [Delete a block](https://docs.versuno.ai/api-reference/assets/delete-a-block.md): Deletes a single block by ID from the target asset.
- [Move asset to trash](https://docs.versuno.ai/api-reference/asset-trash/move-asset-to-trash.md): Soft-deletes the asset by setting `deleted_at`. Recoverable until permanently deleted.
- [Get a trashed asset](https://docs.versuno.ai/api-reference/asset-trash/get-a-trashed-asset.md): Returns metadata for a single trashed asset using the `get_trashed_items` RPC (SECURITY DEFINER), since RLS hides trashed rows from normal queries.
- [Restore a trashed asset](https://docs.versuno.ai/api-reference/asset-trash/restore-a-trashed-asset.md): Clears `deleted_at`, making the asset visible in normal queries again.
- [Permanently delete a trashed asset](https://docs.versuno.ai/api-reference/asset-trash/permanently-delete-a-trashed-asset.md): Hard-deletes the asset row. Only works if the asset is already trashed — active assets return `409`.
- [List trashed assets](https://docs.versuno.ai/api-reference/bulk-asset-trash/list-trashed-assets.md): Returns all trashed assets, optionally filtered to specific IDs via the `assetIds` query param.
- [Bulk move to trash](https://docs.versuno.ai/api-reference/bulk-asset-trash/bulk-move-to-trash.md): Moves assets to trash. If `assetIds` is omitted, trashes **all** non-trashed assets belonging to your account. `assetIds` is capped at 100 per request.
- [Bulk restore from trash](https://docs.versuno.ai/api-reference/bulk-asset-trash/bulk-restore-from-trash.md): Restores assets from trash. If `assetIds` is omitted, restores **all** trashed assets belonging to your account.
- [Bulk permanent delete](https://docs.versuno.ai/api-reference/bulk-asset-trash/bulk-permanent-delete.md): Permanently deletes assets from trash. If `assetIds` is omitted, permanently deletes **all** trashed assets. All provided assets must already be in trash — active assets return `409`. This is irreversible.
- [List version history](https://docs.versuno.ai/api-reference/versioning/list-version-history.md): Returns version history ordered newest-first. Each entry includes the full `assetData` snapshot and author profile.
- [Create a version](https://docs.versuno.ai/api-reference/versioning/create-a-version.md): Manually saves the current asset state as a new version checkpoint. Version number is auto-incremented.
- [Get a version](https://docs.versuno.ai/api-reference/versioning/get-a-version.md): Returns a single version. The `versionId` segment accepts either a UUID or a positive integer version number (e.g. `1`, `2`, `3`). Returns `404` if the version belongs to a different asset.
- [Delete a version](https://docs.versuno.ai/api-reference/versioning/delete-a-version.md): Deletes a version. By default only the **latest** version on its branch may be deleted. Pass `?force=true` to allow deleting a mid-history version. Accepts a UUID or positive integer version number.
- [Revert to version by number](https://docs.versuno.ai/api-reference/versioning/revert-to-version-by-number.md): Creates a **new** version whose `assetData` is copied from the specified version number. Non-destructive — existing history is preserved and the revert appears as a new entry at the head. Use a positive integer for `versionId`.
- [Revert to version by UUID](https://docs.versuno.ai/api-reference/versioning/revert-to-version-by-uuid.md): Creates a **new** version whose `assetData` is copied from the specified version UUID. Non-destructive. Also restores `skill_files` when applicable. If no body is provided, a default description `Reverted to version N: <original description>` is used.
- [List all projects](https://docs.versuno.ai/api-reference/projects/list-all-projects.md): Returns a flat list of all projects ordered by name. Supports filtering by team and specific project IDs.
- [Create a project](https://docs.versuno.ai/api-reference/projects/create-a-project.md): Creates a new project. Set `parentProjectId` to nest it under an existing project.
- [Get a single project](https://docs.versuno.ai/api-reference/projects/get-a-single-project.md): Returns a single non-trashed project.
- [Update a project](https://docs.versuno.ai/api-reference/projects/update-a-project.md): Update `name`, `description`, `emoji`, `parentProjectId`, or `teamId`. Sending unrecognised fields returns `400`.
- [Move project to trash](https://docs.versuno.ai/api-reference/project-trash/move-project-to-trash.md): Soft-deletes the project and its entire subtree (all nested projects and their assets).
- [Get a trashed project](https://docs.versuno.ai/api-reference/project-trash/get-a-trashed-project.md): Returns metadata for a single trashed project using the `get_trashed_items` RPC.
- [Restore a trashed project](https://docs.versuno.ai/api-reference/project-trash/restore-a-trashed-project.md): Restores the project and its entire subtree back to their original locations.
- [Permanently delete a trashed project](https://docs.versuno.ai/api-reference/project-trash/permanently-delete-a-trashed-project.md): Hard-deletes the project and **all its children**. Only works if the project is already trashed — active projects return `409`. Irreversible.
- [CLI Overview](https://docs.versuno.ai/cli/overview.md): The Versuno CLI for managing AI assets, projects, and teams from your terminal.
- [versuno login](https://docs.versuno.ai/cli/login.md): Authenticate with your Versuno API key.
- [versuno logout](https://docs.versuno.ai/cli/logout.md): Remove stored credentials and log out.
- [versuno switch](https://docs.versuno.ai/cli/switch.md): Set the active workspace (team or personal).
- [versuno memory capture](https://docs.versuno.ai/cli/memory-capture.md): Capture your coding agents' memory folders into Versuno, cloud or local.
- [versuno memory recall](https://docs.versuno.ai/cli/memory-recall.md): Search your local memory store without an account.
- [versuno memory install-hook](https://docs.versuno.ai/cli/memory-install-hook.md): Make Claude Code recall your local memory automatically.
- [versuno prompts init](https://docs.versuno.ai/cli/init.md): Scaffold the .versuno/ workspace directory in the current folder.
- [versuno prompts push](https://docs.versuno.ai/cli/push.md): Push modified local assets to the cloud.
- [versuno prompts pull](https://docs.versuno.ai/cli/pull.md): Download an asset from the cloud and write it to disk.
- [versuno prompts status](https://docs.versuno.ai/cli/status.md): Show which local assets have changed relative to the last known state.
- [versuno prompts diff](https://docs.versuno.ai/cli/diff.md): Show the diff between a local file and its latest remote version.
- [versuno prompts log](https://docs.versuno.ai/cli/log.md): Show recent version history for one asset or all tracked assets.
- [versuno versions](https://docs.versuno.ai/cli/versions.md): Show the full version table for a single asset.
- [versuno prompts assets list](https://docs.versuno.ai/cli/assets-list.md): List assets in the active workspace.
- [versuno prompts assets get](https://docs.versuno.ai/cli/assets-get.md): Print an asset's content to stdout without writing to disk.
- [versuno prompts projects list](https://docs.versuno.ai/cli/projects-list.md): List all projects in the active workspace.
- [versuno prompts projects use](https://docs.versuno.ai/cli/projects-use.md): Set or unset the active project.
- [versuno prompts projects pull](https://docs.versuno.ai/cli/projects-pull.md): Pull all assets in a project into a local project subfolder.
- [versuno teams list](https://docs.versuno.ai/cli/teams-list.md): List all teams and your personal workspace.
- [MCP Overview](https://docs.versuno.ai/mcp/overview.md): Versuno MCP server — expose your AI assets to any MCP-compatible coding agent.
- [Setup](https://docs.versuno.ai/mcp/setup.md): Configure the Versuno MCP server in any MCP-compatible client.
- [Cursor](https://docs.versuno.ai/mcp/clients/cursor.md): Connect Versuno MCP to Cursor.
- [Claude Code](https://docs.versuno.ai/mcp/clients/claude-code.md): Connect Versuno MCP to Anthropic's Claude Code CLI.
- [Cline](https://docs.versuno.ai/mcp/clients/cline.md): Connect Versuno MCP to Cline.
- [Claude Desktop](https://docs.versuno.ai/mcp/clients/claude-desktop.md): Connect Versuno MCP to Anthropic's Claude Desktop app.
- [VS Code](https://docs.versuno.ai/mcp/clients/vscode.md): Connect Versuno MCP to VS Code with GitHub Copilot.
- [Windsurf](https://docs.versuno.ai/mcp/clients/windsurf.md): Connect Versuno MCP to Windsurf by Codeium.
- [Codex CLI](https://docs.versuno.ai/mcp/clients/codex.md): Connect Versuno MCP to OpenAI's Codex CLI agent.
- [OpenCode](https://docs.versuno.ai/mcp/clients/opencode.md): Connect Versuno MCP to OpenCode by SST.
- [Zed](https://docs.versuno.ai/mcp/clients/zed.md): Connect Versuno MCP to the Zed editor.
- [Antigravity](https://docs.versuno.ai/mcp/clients/antigravity.md): Connect Versuno MCP to Google's Antigravity IDE.
- [recall_memory](https://docs.versuno.ai/mcp/tools/recall-memory.md): Recall the user's unified memory across all their agents.
- [save_memory](https://docs.versuno.ai/mcp/tools/save-memory.md): Save a durable memory to the user's store so every agent can recall it.
- [list_public_brains](https://docs.versuno.ai/mcp/tools/list-public-brains.md): List the public brains available to query. Returns metadata only.
- [query_brain](https://docs.versuno.ai/mcp/tools/query-brain.md): Semantic search over a public brain. Returns the most relevant passages.
- [get_brain_tree](https://docs.versuno.ai/mcp/tools/get-brain-tree.md): Get a brain's containers as a flat list, each labeled with its path in the hierarchy.
- [get_brain_node](https://docs.versuno.ai/mcp/tools/get-brain-node.md): Fetch the full content of a single brain node.
- [list_assets](https://docs.versuno.ai/mcp/tools/list-assets.md): List Versuno assets filtered by type. Returns metadata only.
- [search_assets](https://docs.versuno.ai/mcp/tools/search-assets.md): Full-text search across your Versuno assets with relevance scoring.
- [get_asset](https://docs.versuno.ai/mcp/tools/get-asset.md): Fetch a Versuno asset's full content and load it into the agent's context.
- [pull_asset](https://docs.versuno.ai/mcp/tools/pull-asset.md): Download an asset to .versuno/ on disk as a markdown file with frontmatter.
- [push_asset](https://docs.versuno.ai/mcp/tools/push-asset.md): Push a local .versuno/ markdown file back to Versuno.
- [Frontmatter Reference](https://docs.versuno.ai/mcp/frontmatter.md): The YAML frontmatter schema used by pull_asset and push_asset tools.
- [Security](https://docs.versuno.ai/mcp/security.md): Risks of connecting an LLM agent to your Versuno account, and how we mitigate them.

## OpenAPI Specs

- [openapi](https://docs.versuno.ai/openapi.yaml)

## Optional

- [Community](https://discord.gg/UT2342QNTg)