> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qontext.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Build applications and workflows that read, search, and update your context repository.

The Qontext API gives your applications HTTP access to the files and folders in a workspace's context repository. Read existing context, search for relevant information, and create or update content from your own systems.

## Base URL

```text theme={null}
https://api.qontext.ai/v1
```

Authenticate with a workspace API key. The key selects the workspace, so requests do not include a workspace ID.

## Start building

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/api-docs/quickstart">Create a file and read it back with your first API requests.</Card>
  <Card title="Authentication" icon="key" href="/api-docs/authentication">Create a key and configure access to your workspace.</Card>
  <Card title="Files" icon="file" href="/api-docs/files/list-files">Read, create, update, move, and delete files.</Card>
  <Card title="Folders" icon="folder" href="/api-docs/folders/list-folders">Organize files and manage folders.</Card>
  <Card title="Search" icon="magnifying-glass" href="/api-docs/search/hybrid-search">Find files by meaning or matching lines with a regular expression.</Card>
  <Card title="OpenAPI specification" icon="code" href="/api-reference/public-api.json">Download the machine-readable contract for the public API.</Card>
</CardGroup>

## API or MCP?

Use the API when your application controls the requests and handles their responses. To give an AI agent tools for working with your context repository, connect it through [MCP](/interfaces/MCP).

The public API documented here covers files, folders, and search. The endpoint reference lists the supported operations and their exact request and response shapes.
