← Docs

API Reference

Base URL: https://api.aut-o.com

All endpoints except /health, /metrics, and /api/auth/* require authentication via Better Auth session cookie.

Authentication

ALL/api/auth/*Better Auth handler (OAuth, sessions)

Projects

GET/api/projectsList user's projects
POST/api/projectsCreate a new project
GET/api/projects/:idGet project details
GET/api/projects/:id/exportExport project (ZIP: HANDOFF.md + README; AI handoff)
PATCH/api/projects/:idUpdate project
DELETE/api/projects/:idDelete project

Pipeline

POST/api/projects/:id/pipeline/runStart a pipeline run
GET/api/projects/:id/pipeline/runsList pipeline runs
GET/api/projects/:id/pipeline/runs/:runIdGet run details
PATCH/api/projects/:id/pipeline/runs/:runIdUpdate run status

Scores

GET/api/projects/:id/scoresList scores for project
GET/api/projects/:id/scores/latestGet latest score
POST/api/projects/:id/scoresRecord a new score

Servers

GET/api/serversList user's servers
POST/api/serversAdd a server
GET/api/servers/:idGet server details
PATCH/api/servers/:idUpdate server
DELETE/api/servers/:idDelete server
POST/api/servers/:id/health-checkTrigger health check

Billing

GET/api/billing/subscriptionGet current subscription
POST/api/billing/checkoutCreate Stripe checkout session
POST/api/billing/portalCreate billing portal session
GET/api/billing/usageGet AI query usage stats
POST/api/billing/webhookStripe webhook handler

Chat (aut-o)

POST/api/chatSingle-turn chat with aut-o (refine idea); returns { reply }

BYOI

GET/api/byoiList BYOI providers and hasKey status
POST/api/byoiSet or rotate key for a provider
DELETE/api/byoi/:providerRemove key for provider

Audit

GET/api/auditList audit logs for current user

System

GET/healthHealth check
GET/metricsPrometheus metrics