# Orchata

## Docs

- [Get Documents Over Time](https://orchata.ai/docs/api-reference/admin/get-documents-over-time.md): Get document upload statistics over time
- [Get Platform Analytics](https://orchata.ai/docs/api-reference/admin/get-platform-analytics.md): Get platform-wide statistics (users, orgs, spaces, documents)
- [Get Users Over Time](https://orchata.ai/docs/api-reference/admin/get-users-over-time.md): Get user growth statistics over time
- [Append to Document](https://orchata.ai/docs/api-reference/documents/append-to-document.md): Append content to an existing document. Fetches current content, appends new content, and regenerates embeddings synchronously.
- [Batch Upload Documents](https://orchata.ai/docs/api-reference/documents/batch-upload-documents.md): Upload multiple documents to a space in a single request. Each document is processed independently. Maximum 100 documents per request.
- [Delete Document](https://orchata.ai/docs/api-reference/documents/delete-document.md): Permanently delete a document and its file from storage
- [Get Document](https://orchata.ai/docs/api-reference/documents/get-document.md): Retrieve a single document by ID
- [Get Document by Filename](https://orchata.ai/docs/api-reference/documents/get-document-by-filename.md): Retrieve a document by filename within a space. Includes document content. Useful when you know the filename but not the document ID.
- [Get Processed Document Content](https://orchata.ai/docs/api-reference/documents/get-processed-document-content.md): Retrieve the processed markdown content for a document. Only available for documents with COMPLETED status.
- [List Documents](https://orchata.ai/docs/api-reference/documents/list-documents.md): Retrieve a paginated list of documents in a space with optional status filtering
- [Update Document](https://orchata.ai/docs/api-reference/documents/update-document.md): Update an existing document's status, error message, or metadata
- [Upload Document](https://orchata.ai/docs/api-reference/documents/upload-document.md): Upload a new document to a space. Supports both file uploads (multipart/form-data) and raw markdown/text content (application/json).
- [Upsert Document](https://orchata.ai/docs/api-reference/documents/upsert-document.md): Create or update a document by filename. If a document with the given filename exists in the space, updates it. Otherwise creates a new document. Embeddings are generated synchronously - the document is immediately queryable.
- [API Reference](https://orchata.ai/docs/api-reference/introduction.md): Complete REST API documentation for Orchata
- [Query Spaces](https://orchata.ai/docs/api-reference/queries/query-spaces.md): Query one or more spaces for similar content. Accepts a single space ID or array of space IDs. Results are merged and globally ranked by default, or can be grouped by space.
- [Smart Query - Discover Relevant Spaces](https://orchata.ai/docs/api-reference/queries/smart-query--discover-relevant-spaces.md): Discover the most relevant spaces for a query using hybrid keyword and embedding similarity. Returns space recommendations (not actual query results).
- [Create Space](https://orchata.ai/docs/api-reference/spaces/create-space.md): Create a new space (knowledge base) in your organization
- [Delete Space](https://orchata.ai/docs/api-reference/spaces/delete-space.md): Soft delete a space by marking it as archived
- [Get Space](https://orchata.ai/docs/api-reference/spaces/get-space.md): Retrieve a single space by ID
- [Get Space Limits](https://orchata.ai/docs/api-reference/spaces/get-space-limits.md): Get current document count and limits for a space based on the organization's tier
- [List Spaces](https://orchata.ai/docs/api-reference/spaces/list-spaces.md): Retrieve a paginated list of spaces with optional status filtering
- [Update Space](https://orchata.ai/docs/api-reference/spaces/update-space.md): Update an existing space's name, description, icon, slug, or archive status
- [Command Reference](https://orchata.ai/docs/cli/commands.md): Complete reference for all Orchata CLI commands
- [CLI Installation](https://orchata.ai/docs/cli/installation.md): Install and configure the Orchata CLI
- [Authentication](https://orchata.ai/docs/getting-started/authentication.md): Learn how to authenticate with the Orchata API
- [Core Concepts](https://orchata.ai/docs/getting-started/concepts.md): Understand Spaces, Documents, and Queries in Orchata
- [Pricing Plans](https://orchata.ai/docs/getting-started/plans.md): Choose the right plan for your needs
- [Quickstart](https://orchata.ai/docs/getting-started/quickstart.md): Get up and running with Orchata in under 5 minutes
- [Introduction](https://orchata.ai/docs/index.md): Build intelligent applications with Orchata
- [MCP Overview](https://orchata.ai/docs/mcp/overview.md): Connect AI assistants to your Orchata knowledge base
- [Resources & Prompts](https://orchata.ai/docs/mcp/resources.md): MCP resources and prompts for guided workflows
- [Claude Desktop Setup](https://orchata.ai/docs/mcp/setup/claude.md): Configure Claude Desktop to use the Orchata MCP server
- [Claude Code Setup](https://orchata.ai/docs/mcp/setup/claude-code.md): Configure Claude Code to use the Orchata MCP server
- [Cursor Setup](https://orchata.ai/docs/mcp/setup/cursor.md): Configure Cursor to use the Orchata MCP server
- [Windsurf Setup](https://orchata.ai/docs/mcp/setup/windsurf.md): Configure Windsurf to use the Orchata MCP server
- [MCP Tools](https://orchata.ai/docs/mcp/tools.md): Complete reference for all 12 Orchata MCP tools
- [AI SDK Integration](https://orchata.ai/docs/sdk/ai-integration.md): Integrate Orchata with Vercel AI SDK v5+ for AI-powered applications
- [Error Handling](https://orchata.ai/docs/sdk/errors.md): Handle errors gracefully with typed error classes
- [SDK Quickstart](https://orchata.ai/docs/sdk/quickstart.md): Get started with the Orchata TypeScript SDK in minutes
- [SDK Usage Guide](https://orchata.ai/docs/sdk/usage.md): Complete guide to using the Orchata TypeScript SDK

## OpenAPI Specs

- [openapi](https://orchata.ai/docs/api/openapi.json)

## Optional

- [Back to Site](https://orchata.ai)