# Soma

> Your organization's knowledge, for people and agents: documents, search, a knowledge graph and cited answers.

- [Soma](https://docs.soma.evarist.com/index.md): Your organization's knowledge, for people and their agents.
- [Quickstart](https://docs.soma.evarist.com/quickstart.md): Install the Soma CLI, sign in and ask your first question.
- [Concepts](https://docs.soma.evarist.com/concepts.md): Workspaces, documents, the knowledge graph and cited answers.
- [Connect an AI app (MCP)](https://docs.soma.evarist.com/connect/ai-apps.md): Use Soma inside Claude, ChatGPT, Cursor, VS Code, Copilot Studio or any MCP client.
- [Coding agents](https://docs.soma.evarist.com/connect/coding-agents.md): Give Claude Code, Codex, Cursor or your own agent your organization's specs, standards and know-how.
- [Soma CLI](https://docs.soma.evarist.com/cli/overview.md): Ask, search and add documents from your terminal; built for people and agents.
- [API overview](https://docs.soma.evarist.com/api/overview.md): Base URL, authentication, errors, pagination and limits.
- [Ask](https://docs.soma.evarist.com/api/ask.md): Get an answer with citations from a workspace, in one call or streamed.
- [MCP tools](https://docs.soma.evarist.com/mcp/tools.md): What an agent can do with Soma's MCP server.
- [Get the current caller](https://docs.soma.evarist.com/api-reference/workspaces/get-the-current-caller.md)
- [List workspaces](https://docs.soma.evarist.com/api-reference/workspaces/list-workspaces.md): The workspaces the caller can read.
- [Create a workspace](https://docs.soma.evarist.com/api-reference/workspaces/create-a-workspace.md): Creates a workspace; the caller becomes its owner.
- [Get a workspace](https://docs.soma.evarist.com/api-reference/workspaces/get-a-workspace.md)
- [Delete a workspace](https://docs.soma.evarist.com/api-reference/workspaces/delete-a-workspace.md): Removes the workspace and its memberships for everyone and stops its ingestions. Its documents stay indexed for the other workspaces that use them.
- [Update a workspace](https://docs.soma.evarist.com/api-reference/workspaces/update-a-workspace.md): Rename a workspace or change its description (owner or editor).
- [List documents](https://docs.soma.evarist.com/api-reference/documents/list-documents.md): The documents of a workspace's knowledge base.
- [Read a document](https://docs.soma.evarist.com/api-reference/documents/read-a-document.md): Returns the document's chunks in reading order, about `max_chars` characters per page. Use it for tables and matrices, which search returns only in part.
- [Upload files](https://docs.soma.evarist.com/api-reference/documents/upload-files.md): PDF, Word, PowerPoint, Excel, CSV, Markdown, text and images. Files are parsed and indexed in the background: poll the returned job with GET /v1/jobs/{job_id}. Up to 20 files per request.
- [Get an upload job](https://docs.soma.evarist.com/api-reference/documents/get-an-upload-job.md)
- [Search documents](https://docs.soma.evarist.com/api-reference/search/search-documents.md): Hybrid (semantic + keyword) search. Returns the most relevant chunks, best first.
- [List sub-scopes](https://docs.soma.evarist.com/api-reference/search/list-sub-scopes.md): Named subsets of the workspace's documents; pass a name as `scope` to search.
- [List entities](https://docs.soma.evarist.com/api-reference/knowledge-graph/list-entities.md): With `q`: the best matches by name and meaning (at most 25, no further page). Without: every entity, ordered by type then name.
- [Get an entity](https://docs.soma.evarist.com/api-reference/knowledge-graph/get-an-entity.md): An entity of the knowledge graph and its relations.
- [Get main themes](https://docs.soma.evarist.com/api-reference/knowledge-graph/get-main-themes.md): The workspace's main entities and entity types.
- [Ask a question](https://docs.soma.evarist.com/api-reference/ask/ask-a-question.md): Soma's agent searches the workspace (documents and knowledge graph) as many times as it needs, then answers in markdown with `[N]` markers; `citations` gives the passage behind each N. An answer takes 10 to 120 seconds; use `stream` to follow progress.

## OpenAPI Specs

- [openapi](https://staging.soma.evarist.com/v1/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.