API Documentation

Initial protocol-style API index. We will expand this into full request/response examples and SDK-ready docs.

Auth & Accounts

  • GET /api/v1/auth/bootstrap/status
  • POST /api/v1/auth/bootstrap/admin
  • GET /api/v1/auth/invites
  • POST /api/v1/auth/invites
  • POST /api/v1/auth/invites/accept
  • GET /api/v1/auth/audit-logs
  • GET /api/v1/auth/security
  • GET /api/v1/auth/users
  • PATCH /api/v1/auth/users/{id}
  • POST /api/v1/auth/oidc/link

Projects & Runs

  • GET /api/v1/teams
  • POST /api/v1/teams
  • GET /api/v1/projects
  • POST /api/v1/projects
  • GET /api/v1/projects/{id}/sites
  • POST /api/v1/projects/{id}/sites
  • PATCH /api/v1/projects/{id}/sites/{site_id}
  • DELETE /api/v1/projects/{id}/sites/{site_id}
  • GET /api/v1/projects/{id}/sites/{site_id}/review
  • POST /api/v1/projects/{id}/sites/{site_id}/review/annotations
  • GET /api/v1/projects/{id}/sites/{site_id}/knowledge
  • POST /api/v1/projects/{id}/sites/{site_id}/knowledge/query-families
  • POST /api/v1/projects/{id}/sites/{site_id}/knowledge/facts
  • POST /api/v1/projects/{id}/sites/{site_id}/knowledge/hypotheses
  • PATCH /api/v1/projects/{id}/sites/{site_id}/knowledge/hypotheses/{hypothesis_id}
  • POST /api/v1/projects/{id}/sites/{site_id}/knowledge/internal-improvements/{improvement_id}/complete
  • POST /api/v1/projects/{id}/sites/{site_id}/knowledge/internal-improvements/{improvement_id}/reopen
  • POST /api/v1/projects/{id}/audits
  • GET /api/v1/projects/{id}/runs
  • DELETE /api/v1/projects/{id}/runs/{run_id}
  • GET /api/v1/projects/{id}/runs/{run_id}/artifacts
  • GET /api/v1/projects/{id}/runs/{run_id}/artifacts/{file}
  • GET /api/v1/projects/{id}/runs/{run_id}/artifacts.zip
  • GET /api/v1/projects/{id}/events
  • POST /api/v1/projects/{id}/schedules
  • GET /api/v1/projects/{id}/schedules

Reporting

  • GET /api/v1/projects/{id}/reporting/summary
  • GET /api/v1/projects/{id}/reporting/artifacts
  • GET /api/v1/projects/{id}/reporting/attribution
  • GET /api/v1/projects/{id}/reporting/personas
  • GET /api/v1/projects/{id}/reporting/relevance
  • GET /api/v1/projects/{id}/reporting/trust
  • GET /api/v1/projects/{id}/reporting/source-ecosystem
  • GET /api/v1/projects/{id}/reporting/source-gaps
  • GET /api/v1/projects/{id}/reporting/geo-observations
  • GET /api/v1/projects/{id}/reporting/geo-trends