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

# Overview

> Complete reference for the Adapter API

<Warning>
  Adapter is in alpha. Endpoints, request shapes, and response fields can change without notice.
</Warning>

## Base URL

All requests should be made to:

```
https://api.adapter.com/v1
```

## Authentication

Every endpoint requires an API key passed in the `Authorization` header:

```bash theme={null}
curl https://api.adapter.com/v1/connections \
  -H "Authorization: Bearer $ADAPTER_API_KEY"
```

<Warning>
  Never expose API keys in client-side code or public repositories. Use environment variables.
</Warning>

See the [API Keys guide](/getting-started/api-keys) for creating and managing keys.

## Response format

Responses return JSON resources directly, without an envelope. Single resources are returned as JSON objects; collections as JSON arrays. Endpoints that return additional metadata (pagination cursors, counts) document those fields inline on each response.

## Errors

See the [Errors reference](/api-reference/errors) for all error codes and response shapes.

## Available endpoints

<CardGroup cols={2}>
  <Card title="Connectors" icon="plug" href="/api-reference/connectors/list-connections">
    List and inspect your connected data sources
  </Card>

  <Card title="Custom Connectors" icon="cloud-arrow-up" href="/api-reference/custom-connectors/list-custom-connectors">
    Manage your own data sources and push events into Adapter
  </Card>

  <Card title="Knowledge" icon="magnifying-glass" href="/api-reference/knowledge/search">
    Search, query, and retrieve context from your data
  </Card>
</CardGroup>