Cornelius uses server-side API keys configured via environment variables. No client authentication is required for the REST API itself. The server handles GitHub Proxy and Anthropic API authentication internally.

Each review runs a set of checks against the target repository. Checks are either rule-based (deterministic) or AI-powered (uses Claude).

Presets configure which checks are enabled, required, and their parameters. Pass a preset name to any review endpoint.

Review a single GitHub repository. Runs all enabled checks from the selected preset and returns detailed results.

// POST /api/review
// Content-Type: application/json

{
  "url": "https://github.com/user/hardware-project",
  "preset": "blueprint"
}

{
  "githubUrl": "https://github.com/user/hardware-project",
  "status": "pass",
  "overallPass": true,
  "checkResults": [
    {
      "checkName": "github_link_works",
      "required": true,
      "status": "pass",
      "confidence": 1.0,
      "evidence": ["https://github.com/user/hardware-project"],
      "reason": "Repository is accessible and contains files",
      "aiUsed": false
    }
    // ... more check results
  ],
  "warnings": [],
  "errors": [],
  "aiSummary": "Project has complete PCB and CAD files...",
  "suggestedFixes": [],
  "confidenceScore": 0.95
}

Upload a CSV file of repositories for batch review. Returns a job ID to poll for progress. The CSV must have a github_url column.

// Required: github_url column
// Optional: project_type, program_preset, submission_id, participant_name, email, notes

github_url,submission_id,participant_name
https://github.com/user/project-a,001,Alice
https://github.com/user/project-b,002,Bob

{
  "jobId": "m5x8k2abc1",
  "status": "processing"
}

Poll for batch job progress and results. Returns current status, completion count, and results array when complete.

{
  "status": "processing",
  "total": 50,
  "completed": 12,
  "results": []
}

{
  "status": "complete",
  "total": 50,
  "completed": 50,
  "results": [
    {
      "submissionId": "001",
      "githubUrl": "https://github.com/user/project-a",
      "projectType": "hardware",
      "overallStatus": "pass",
      "passedChecks": ["github_link_works", "readme_present"],
      "failedChecks": [],
      "warnings": [],
      "reviewSummary": "All checks passed",
      "confidenceScore": 0.98
    }
    // ... more results
  ]
}

Returns server health status and whether API keys are configured.

{
  "status": "ok",
  "version": "1.0.0",
  "github": true,   // GH_PROXY_API_KEY configured
  "ai": false        // ANTHROPIC_API_KEY configured
}