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

# API Overview

> Base URL, authentication, and public endpoints.

Base URL:

```text theme={"theme":"github-light"}
https://api.driftless.icu/api/v1
```

## Authentication

Most endpoints require either a Clerk session from the dashboard or an API key from the CLI.

```bash theme={"theme":"github-light"}
curl https://api.driftless.icu/api/v1/workspaces/acme/repos \
  -H "x-api-key: drift_your_api_key_here"
```

<Warning>
  Treat API keys as secrets. Driftless stores keys encrypted and only shows the raw value once when created.
</Warning>

## Public endpoints

These endpoints do not require authentication:

| Method | Path                | Purpose                         |
| ------ | ------------------- | ------------------------------- |
| `GET`  | `/health`           | Runtime health check            |
| `GET`  | `/version`          | API version and deploy metadata |
| `POST` | `/workspaces`       | Workspace bootstrap             |
| `GET`  | `/blog/posts`       | Public blog index               |
| `GET`  | `/blog/posts/:slug` | Public blog post                |
| `POST` | `/webhooks/github`  | GitHub App webhook receiver     |
| `POST` | `/webhooks/clerk`   | Clerk webhook receiver          |

## Auth and API keys

| Method   | Path                             | Purpose                                |
| -------- | -------------------------------- | -------------------------------------- |
| `GET`    | `/me`                            | Current identity and workspace context |
| `POST`   | `/workspaces/:slug/api-keys`     | Create an API key for that workspace   |
| `GET`    | `/workspaces/:slug/api-keys`     | List a workspace's API keys            |
| `DELETE` | `/workspaces/:slug/api-keys/:id` | Revoke an API key                      |

## OAuth

OAuth 2.0 endpoints for MCP client applications:

| Method | Path               | Purpose                                      |
| ------ | ------------------ | -------------------------------------------- |
| `GET`  | `/oauth/authorize` | Authorization consent screen                 |
| `POST` | `/oauth/token`     | Exchange authorization code for access token |
| `POST` | `/oauth/register`  | Register an OAuth client                     |
| `POST` | `/oauth/revoke`    | Revoke an access token                       |

## Resource references

Detailed endpoint references by resource:

* [Projects and Cards](/api/projects)
* [Collections, Records, and Entities](/api/collections)
* [Broker and Connections](/api/broker)
* [Comments, Areas, and Tags](/api/collaboration)
* [Topics](/api/topics)
* [Integrations and PR Activity](/api/integrations)
* [Workspaces](/api/workspaces)
* [Repos](/api/repos)
* [Errors](/api/errors)