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
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
| 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 identity
| Method | Path | Purpose |
|---|
GET | /me | Current identity and workspace context |
POST | /auth/api-keys | Create an API key |
GET | /auth/api-keys | List API keys for the workspace |
DELETE | /auth/api-keys/:id | Revoke an API key |
Workspaces
| Method | Path | Purpose |
|---|
GET | /workspaces/:slug | Get workspace details |
PATCH | /workspaces/:slug | Update workspace settings |
GET | /workspaces/:slug/health | Workspace health summary |
GET | /workspaces/:slug/members | List members |
POST | /workspaces/:slug/members | Invite a member |
DELETE | /workspaces/:slug/members/:memberId | Remove a member |
Repositories and scans
| Method | Path | Purpose |
|---|
GET | /workspaces/:slug/repos | List repositories |
POST | /workspaces/:slug/repos | Register a repository |
GET | /workspaces/:slug/repos/:id | Get repository details |
PATCH | /workspaces/:slug/repos/:id | Update repository metadata |
DELETE | /workspaces/:slug/repos/:id | Delete a repository |
POST | /workspaces/:slug/repos/:id/components | Upload extracted components |
POST | /workspaces/:slug/repos/:id/baseline | Upload a baseline scan |
POST | /workspaces/:slug/repos/:id/scan | Upload a scan result |
GET | /workspaces/:slug/repos/:id/architecture-summary | Architecture summary |
GET | /workspaces/:slug/repos/:id/components/:componentName | Component detail |
POST | /workspaces/:slug/repos/:id/context/load | Match files to context |
GET | /workspaces/:slug/repos/:id/graph/file | File graph |
GET | /workspaces/:slug/repos/:id/graph/impact | Impact graph |
Topics
The API keeps the legacy route name watchers for compatibility. The product language is topics.
| Method | Path | Purpose |
|---|
GET | /workspaces/:slug/watchers | List topics |
POST | /workspaces/:slug/watchers | Create a topic |
GET | /workspaces/:slug/watchers/search | Search topics |
GET | /workspaces/:slug/watchers/audit | Context health audit |
GET | /workspaces/:slug/watchers/events | Topic event timeline |
POST | /workspaces/:slug/watchers/match-files | Match files to topics |
GET | /workspaces/:slug/watchers/graph | Topic graph |
GET | /workspaces/:slug/watchers/:watcherSlug | Get topic detail |
PATCH | /workspaces/:slug/watchers/:watcherSlug | Update a topic |
DELETE | /workspaces/:slug/watchers/:watcherSlug | Delete a topic |
POST | /workspaces/:slug/watchers/:watcherSlug/relations | Add a relation |
GET | /workspaces/:slug/watchers/:watcherSlug/relations | List relations |
DELETE | /workspaces/:slug/watchers/:watcherSlug/relations/:relationId | Delete a relation |
Integrations and PR activity
| Method | Path | Purpose |
|---|
GET | /workspaces/:slug/integrations | List integrations |
POST | /workspaces/:slug/integrations | Create or connect an integration |
DELETE | /workspaces/:slug/integrations/:id | Remove an integration |
GET | /workspaces/:slug/pr-activity | Observed pull request activity |
