Base URL:
https://api.driftless.icu/api/v1
Authentication
Most endpoints require either a Clerk session from the dashboard or an API key from the CLI.
curl https://api.driftless.icu/api/v1/workspaces/acme/repos \
-H "x-api-key: drift_your_api_key_here"
Treat API keys as secrets. Driftless stores keys encrypted and only shows the raw value once when created.
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:
