Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sigilix.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Sigilix API is in private beta. Endpoints, payload shapes, and rate limits may change without backward-compat guarantees until v1 GA.

​
Base URL

https://api.sigilix.ai/v1
All endpoints accept JSON and return JSON. Authentication via Authorization: Bearer <PAT> — see Authentication.

​
Reviews

​
List reviews

GET /v1/reviews?owner=:owner&repo=:repo&pr=:number&limit=:n
Returns a paginated list of past reviews on a PR. 
{
  "reviews": [
    {
      "id": "rev_2y8tA9...",
      "owner": "Arc-and-Anchor",
      "repo": "sigilix",
      "pr_number": 42,
      "head_sha": "a1b2c3d4",
      "verdict": "request_changes",
      "synthesized_at": "2026-05-05T03:14:00Z",
      "specialists_succeeded": ["glyph", "warden", "spark", "weave"],
      "findings_count": 4,
      "summary": "Core synthesized 4 findings across 3 specialists..."
    }
  ],
  "next_cursor": null
}

​
Get a review

GET /v1/reviews/:id
Returns the full review including all findings. 
{
  "id": "rev_2y8tA9...",
  "owner": "Arc-and-Anchor",
  "repo": "sigilix",
  "pr_number": 42,
  "head_sha": "a1b2c3d4",
  "verdict": "request_changes",
  "summary": "...",
  "findings": [
    {
      "id": "fnd_4c2bX1...",
      "specialist": "warden",
      "category": "security",
      "severity": "critical",
      "path": "src/api/checkout.ts",
      "line": 142,
      "headline": "missing CSRF verification on POST /checkout",
      "body": "...",
      "suggested_patch": null
    }
  ]
}

​
Findings

​
Fetch a finding

GET /v1/findings/:id
Returns a single finding with its full context (provenance, source-line excerpt, suggested patch if applicable).

​
Webhooks

See Webhooks for the outbound events Sigilix can fire when a review completes.

​
Errors

StatusMeaning
401Missing or invalid PAT
403PAT lacks required scope
404Resource not found
429Rate limit exceeded
500Internal error — retry with exponential backoff
Error bodies follow the JSON Problem Details format: 
{
  "type": "https://docs.sigilix.ai/api/errors#unauthorized",
  "title": "Invalid PAT",
  "status": 401,
  "detail": "The provided personal access token does not exist or has been revoked."
}

Webhooks

Outbound events for review.completed, finding.created, etc.

Authentication

PAT scopes and rate limits.