# Versuno Docs ## Docs - [API Guide](https://docs.versuno.ai/api-guide.md): Authentication, quick start examples, error handling, and key endpoints for the Versuno Public API. - [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. - [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. - [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`. - [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. - [Apply block operations](https://docs.versuno.ai/api-reference/assets/apply-block-operations.md): Applies structural block transforms using the unified turn_into command. - [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. - [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. - [Delete a block](https://docs.versuno.ai/api-reference/assets/delete-a-block.md): Deletes a single block by ID from the target asset. - [Get a block](https://docs.versuno.ai/api-reference/assets/get-a-block.md): Returns a single block by ID from the target asset. - [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. - [Get all blocks](https://docs.versuno.ai/api-reference/assets/get-all-blocks.md): Returns the full block tree for the target asset. - [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. - [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. - [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`. - [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. - [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 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. - [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. - [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. - [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. - [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). - [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. - [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. - [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. - [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. - [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`. - [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. - [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. - [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. - [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. - [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. - [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: ` is used. - [Context](https://docs.versuno.ai/asset-types/context.md): Knowledge base and reference material for AI agents. - [Persona](https://docs.versuno.ai/asset-types/persona.md): AI personalities and behavioral guidelines for consistent identity. - [Prompt](https://docs.versuno.ai/asset-types/prompt.md): Task-oriented instructions for a single AI interaction. - [Skill](https://docs.versuno.ai/asset-types/skill.md): Reusable capability packages 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. - [versuno assets get](https://docs.versuno.ai/cli/assets-get.md): Print an asset's content to stdout without writing to disk. - [versuno assets list](https://docs.versuno.ai/cli/assets-list.md): List assets in the active workspace. - [versuno diff](https://docs.versuno.ai/cli/diff.md): Show the diff between a local file and its latest remote version. - [versuno init](https://docs.versuno.ai/cli/init.md): Scaffold the .versuno/ workspace directory in the current folder. - [versuno log](https://docs.versuno.ai/cli/log.md): Show recent version history for one asset or all tracked assets. - [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. - [CLI Overview](https://docs.versuno.ai/cli/overview.md): The Versuno CLI — manage AI assets, projects, and teams from your terminal. - [versuno projects list](https://docs.versuno.ai/cli/projects-list.md): List all projects in the active workspace. - [versuno projects pull](https://docs.versuno.ai/cli/projects-pull.md): Pull all assets in a project into a local project subfolder. - [versuno pull](https://docs.versuno.ai/cli/pull.md): Download an asset from the cloud and write it to disk. - [versuno push](https://docs.versuno.ai/cli/push.md): Push modified local assets to the cloud. - [versuno status](https://docs.versuno.ai/cli/status.md): Show which local assets have changed relative to the last known state. - [versuno switch](https://docs.versuno.ai/cli/switch.md): Set the active workspace (team or personal). - [versuno teams list](https://docs.versuno.ai/cli/teams-list.md): List all teams and your personal workspace. - [versuno versions](https://docs.versuno.ai/cli/versions.md): Show the full version table for a single asset. - [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. - [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. - [Overview](https://docs.versuno.ai/index.md): The context layer for AI agents. - [MCP vs CLI](https://docs.versuno.ai/mcp-vs-cli.md): Choosing between the Versuno MCP server and the Versuno CLI. - [Antigravity](https://docs.versuno.ai/mcp/clients/antigravity.md): Connect Versuno MCP to Google's Antigravity IDE. - [Claude Code](https://docs.versuno.ai/mcp/clients/claude-code.md): Connect Versuno MCP to Anthropic's Claude Code CLI. - [Claude Desktop](https://docs.versuno.ai/mcp/clients/claude-desktop.md): Connect Versuno MCP to Anthropic's Claude Desktop app. - [Cline](https://docs.versuno.ai/mcp/clients/cline.md): Connect Versuno MCP to Cline. - [Codex CLI](https://docs.versuno.ai/mcp/clients/codex.md): Connect Versuno MCP to OpenAI's Codex CLI agent. - [Cursor](https://docs.versuno.ai/mcp/clients/cursor.md): Connect Versuno MCP to Cursor. - [OpenCode](https://docs.versuno.ai/mcp/clients/opencode.md): Connect Versuno MCP to OpenCode by SST. - [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. - [Zed](https://docs.versuno.ai/mcp/clients/zed.md): Connect Versuno MCP to the Zed editor. - [Frontmatter Reference](https://docs.versuno.ai/mcp/frontmatter.md): The YAML frontmatter schema used by pull_asset and push_asset. - [MCP Overview](https://docs.versuno.ai/mcp/overview.md): Versuno MCP server — expose your AI assets to any MCP-compatible coding agent. - [Security](https://docs.versuno.ai/mcp/security.md): Risks of connecting an LLM agent to your Versuno account, and how we mitigate them. - [Setup](https://docs.versuno.ai/mcp/setup.md): Configure the Versuno MCP server in any MCP-compatible client. - [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. - [list_assets](https://docs.versuno.ai/mcp/tools/list-assets.md): List Versuno assets filtered by type. Returns metadata only. - [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. - [search_assets](https://docs.versuno.ai/mcp/tools/search-assets.md): Full-text search across your Versuno assets with relevance scoring. ## OpenAPI Specs - [openapi](https://docs.versuno.ai/openapi.yaml) ## Optional - [Community](https://discord.gg/UT2342QNTg)