API / public contracts

Hugin API

Public JSON contracts for monitors, dashboards, mirrors, and evidence clients. Probe freshness with HEAD, reuse ETags with If-None-Match, then fetch the body only when the record changes.

45documented HEAD probes30hash receipt headers29civic and archive validators

Start hereHEAD /api/v1/civic/bundle

Check freshness before fetching bodies.

Hugin keeps public reads cheap and cache-friendly. A monitor can send a HEAD request, compare the ETag, and skip the heavier JSON response when the bundle is unchanged.

curl -I https://hugin.studio/api/v1/civic/bundle
curl https://hugin.studio/api/v1/civic/bundle \
  -H 'If-None-Match: <etag-from-last-response>'

Guardrails

Open reads with explicit budgets and public status.

Public status Free resources Cost transparency

60 requestsper IP, per minute300s index cachestale-while-revalidate enabledFail closeddaily public spend guardrailNo accountrequired for public reads

HEAD /.well-known/hugin.jsonX-Hugin-Discovery-ETagWell-known Hugin site discovery validators.

HEAD /api/v1X-Hugin-API-Index-ETagAPI index validators.

HEAD /api/v1/statusX-Hugin-Status-ETagPublic status validators.

HEAD /api/v1/limitsX-Hugin-Limits-ETagPublic budget and limiter validators.

HEAD /api/v1/contentX-Hugin-Content-Index-ETagAuthored Journal and News content index validators.

HEAD /api/v1/integrationsX-Hugin-Integration-Manifest-ETagIntegration manifest validators.

HEAD /api/v1/openapiX-Hugin-OpenAPI-ETagOpenAPI contract validators.

HEAD /api/v1/promotion/readinessX-Hugin-Promotion-Readiness-ETagDraft-only promotion and SEO readiness validators.

HEAD /api/v1/promotion/draftsX-Hugin-Promotion-Drafts-ETagManual-approval promotion draft packet validators.

HEAD /api/v1/promotion/share-queueX-Hugin-Promotion-Share-Queue-ETagManual-only promotion share queue validators.

HEAD /api/v1/civic/bundleX-Hugin-Civic-Bundle-ETagCivic bundle manifest validators.

HEAD /api/v1/civic/sourcesX-Hugin-Civic-Sources-ETagCivic source registry validators.

HEAD /api/v1/civic/cases/source-discoveryX-Hugin-Civic-Case-Source-Discovery-ETagAggregate case source-desk and source-atlas discovery validators.

HEAD /api/v1/civic/cases/source-atlasesX-Hugin-Civic-Case-Source-Atlases-ETagAggregate all-case source atlas validators.

HEAD /api/v1/civic/cases/source-anchorsX-Hugin-Civic-Case-Source-Anchors-ETagFlat verified case source-anchor export validators.

HEAD /api/v1/civic/cases/claim-source-matrixX-Hugin-Civic-Claim-Source-Matrix-ETagClaim-to-source matrix validators.

HEAD /api/v1/civic/cases/claim-ledgersX-Hugin-Civic-Case-Claim-Ledger-Index-ETagAggregate case claim-ledger index validators.

HEAD /api/v1/civic/cases/verification-packetsX-Hugin-Civic-Case-Verification-Packets-ETagCase verification-packet bundle validators.

HEAD /api/v1/civic/cases/workbenchX-Hugin-Civic-Case-Workbench-ETagRanked case verification workbench validators.

HEAD /api/v1/civic/cases/source-scoutX-Hugin-Civic-Case-Source-Scout-ETagReview-only case source scout target validators.

HEAD /api/v1/civic/cases/source-scout?view=summaryX-Hugin-Civic-Case-Source-Scout-ETagCompact case source scout summary validators.

HEAD /api/v1/civic/cases/source-scout?view=summary&format=markdownX-Hugin-Civic-Case-Source-Scout-ETagReadable case source scout summary Markdown validators.

HEAD /api/v1/civic/cases/source-scout?view=first-passX-Hugin-Civic-Case-Source-Scout-ETagCredentialless first-pass case source scout validators.

HEAD /api/v1/civic/fact-checkETagCivic fact-check review desk validators.

HEAD /api/v1/civic/source-runsX-Hugin-Civic-Source-Runs-ETagCivic source-run packet validators.

Discovery

Machine-readable entrypoints

Start with the index, then let generated clients use the OpenAPI contract or the integration manifest.

GET /.well-known/hugin.jsonSite discoveryHuman pages, machine contracts, feeds, security, cache policy, and citation rules.

GET /api/v1Index JSONRoutes, budgets, limits, validators, and license context.

GET /api/v1/openapiOpenAPI 3.1Generated-client contract with the same HEAD probes documented.

GET /api/v1/contentContent indexAuthored URLs, evidence posture, source-record lanes, public-record links, source receipts, source hosts, feeds, share metadata, and section/slug filters.

GET /api/v1/content?section=news&slug={slug}Single article JSONFetch one news or journal record with the same canonical page, evidence posture, source-record lanes, feed, share, and source receipt fields.

GET /api/v1/integrationsIntegration manifestEmbed paths, event shapes, direct scan handoffs, and summaries.

GET /opensearch.xmlOpenSearch descriptorBrowser and local-agent search descriptor for Hugin public report queries.

Open discovery JSON

Promotion

Manual-gated promotion prep

Prepare source-backed channel drafts, canonical links, and source requirements without scheduling or posting.

GET /api/v1/promotion/readinessReadiness packetChannel gates, source-desk counts, claim-ledger posture, launch-day monitors, canonical URLs, manual SEO launch kit, SEO targets, and automatic sharing disabled.

GET /api/v1/promotion/draftsManual draft packetX, LinkedIn, Reddit, and newsletter draft copy with source URLs, source requirements, and manual approval gates.

GET /api/v1/promotion/share-queueManual share queueChannel review rows, recheck URLs, queue hashes, and automatic dispatch disabled.

Promotion readiness

Evidence

Reports, search, and archive reads

Pull recent evidence packets, search public reports, or resolve a single stable report URL.

GET /api/v1/recentRecent archiveLatest reports as JSON or CSV, capped for public clients.

GET /api/v1/searchSearchFind reports by title, community, author, or public URL context.

GET /api/v1/r/{slug}Report detailVerdict, evidence trail, metrics, flags, and exportable context.

Recent reports

Civic

Hash-verifiable civic bundles

Mirror neutral civic packets, source receipts, claim ledgers, and case-file manifests with stable hashes.

GET /api/v1/civic/bundleBundle manifestArtifact URLs, hashes, dependency links, and mirror storage paths.

GET /api/v1/civic/source-receiptsSource receiptsAccepted observations, source errors, payload hashes, and review gates.

GET /api/v1/civic/fact-checkFact-check deskNeutral claim and case posture with ranked reviewQueue rows, a source-first verification playbook, claim-source matrix and source-anchor receipt hashes, freshness checks, no-verdict guardrails, and priority-scored blocker-aware evidence-linked CSV/JSONL exports.

GET /api/v1/civic/sources?view=ai-release-receiptsAI release source viewOfficial OpenAI, Anthropic, status, docs, safety-card, and coverage-index source posture.

GET /api/v1/civic/source-runs?view=ai-release-receiptsAI release source runsBounded request targets, storage paths, output tables, and join keys for model-release receipt mirrors.

GET /api/v1/civic/sources?view=stock-act-news-correlationSTOCK Act source viewDisclosure, issuer, Congress.gov, and coverage-index rows for review-only timing joins.

GET /api/v1/civic/sources?view=court-record-anchorsCourt-record source viewDOJ, court, GovInfo opinion, state-record, and RECAP source posture for legal-record review.

GET /api/v1/civic/source-runs?view=court-record-anchorsCourt-record source runsBounded request targets, storage paths, auth gates, and output tables for court-record mirrors.

GET /api/v1/civic/casesCase indexPublic-record case files with neutral source and entity guardrails.

GET /api/v1/civic/cases/source-discoveryCase source discoveryAggregate source-desk leads, atlas counts, source-view URLs, source-run URLs, and manual sharing gates.

GET /api/v1/civic/cases/source-atlasesCase source atlasesAll-case source-family coverage, per-case atlas summaries, credential gates, full atlas payloads, and Markdown export.

GET /api/v1/civic/cases/source-anchorsVerified source anchorsFlat verified case source-anchor rows with timeline references, source URLs, packet links, CSV, JSONL, and no-allegation guardrails.

GET /api/v1/civic/cases/claim-source-matrixClaim source matrixFlat claim-to-source join rows with source URLs, publishable state, review gates, CSV, JSONL, Markdown, and no-verdict guardrails.

GET /api/v1/civic/cases/claim-ledgersClaim-ledger indexAggregate case claim posture, publishable rows, source-repair counts, per-case ledger links, and Markdown handoff.

GET /api/v1/civic/cases/verification-packetsCase verification packetsAggregate or case-scoped review bundles with claim checklists, source anchors, first-pass source rows, hashes, and Markdown export.

GET /api/v1/civic/cases/{caseId}/verification-packetPer-case verification packetPretty case-scoped alias for the same claim checklist, source anchor, first-pass row, hash, and Markdown review bundle.

GET /api/v1/civic/cases/workbenchCase workbenchRanked per-case action rows for packets, claim ledgers, source-anchor exports, claim-source matrix review, first-pass source-scout queues, source validation, atlases, and fact-check desk checks.

GET /api/v1/civic/cases/source-scoutCase source scoutReview-only public connector targets, query URLs, POST templates, CSV/JSONL/Markdown exports, docs links, and no automatic ingest.

GET /api/v1/civic/cases/source-scout?view=summarySource scout summaryCompact source-scout review queue with access mix, first-pass targets, a credentialless starter kit, case priorities, connector focus, and launch-safe review actions.

GET /api/v1/civic/cases/source-scout?view=summary&format=markdownSource scout summary MarkdownReadable first-pass, credentialless starter rows, credential, and manual POST review handoff for launch-day source checks.

GET /api/v1/civic/cases/source-scout?view=connectorsSource connector matrixConnector-family target counts, access classes, case coverage, credential gates, first-pass eligibility, and Markdown/CSV/JSONL exports.

GET /api/v1/civic/cases/source-scout?view=first-passFirst-pass scout queueCredentialless/keyless source-scout rows for immediate public review, excluding free-key and POST-template queues.

GET /api/v1/civic/cases/source-scout?case={caseId}Case-scoped scout packetFilter the scout JSON, CSV, JSONL, or Markdown export to one public-record case desk.

GET /api/v1/civic/cases/source-scout?format=csvSource scout CSVFlat case/query/connector rows for spreadsheet triage and public review queues.

GET /api/v1/civic/cases/source-scout?format=jsonlSource scout JSONLLine-delimited source-scout targets for mirrors, local agents, and append-only logs.

GET /api/v1/civic/cases/source-scout?format=markdownSource scout MarkdownHuman-readable scout review handoff with gates, case targets, connector docs, and distribution links.

Civic bundle