Skip to main content

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.

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:
MethodPathPurpose
GET/healthRuntime health check
GET/versionAPI version and deploy metadata
POST/workspacesWorkspace bootstrap
GET/blog/postsPublic blog index
GET/blog/posts/:slugPublic blog post
POST/webhooks/githubGitHub App webhook receiver
POST/webhooks/clerkClerk webhook receiver

​
Auth and API keys

MethodPathPurpose
GET/meCurrent identity and workspace context
POST/auth/api-keysCreate an API key
GET/auth/api-keysList API keys for the workspace
DELETE/auth/api-keys/:idRevoke an API key