GET/v1/uops
List UoPs
Returns every UoP visible to the authenticated caller, filterable by enterprise, archetype, maturity stage, or confidence tier. Each row carries its Alignment Score, maturity, and provenance.
Parameters
| enterprise | query | string | Enterprise slug (e.g. `tag`, `jpmorgan-chase`) |
| archetype | query | string | Archetype slug (`legal-drafting`, `software-engineering`, …) |
| stage | query | enum | `generated` · `configured` · `in_production` |
| confidence | query | enum | `estimated` · `modeled` · `configured` · `measured` |
Response: Array<UoP>
GET/v1/uops/:id
Retrieve one UoP
Returns the full 5-section UoP anatomy: Alignment Decision · Configuration · Workforce Impact · Stakeholder Alignment · Live Telemetry. Pulls from `public.v_uop_live` in the supply-side substrate.
Parameters
| id | path | string | UoP id (e.g. `TAG-LGL-001`) |
Response: UoP
GET/v1/enterprises
List enterprises with absorption scores
Returns the 30-row Doolan cohort (expandable to 500 + 14,200). Each row has firmographics, composite score, tier (ready/gated/blocked), per-archetype cells, and Reason chips on Gated cells.
Parameters
| archetype | query | string | Score by a single archetype (returns per-archetype composite) |
| tier | query | enum | `ready` · `gated` · `blocked` |
| limit | query | number | Default 30; max 500 for v1 visitors |
Response: Array<Enterprise>
GET/v1/archetypes
List the 7 canonical archetypes
Returns the 7 supply-side archetypes with Eloundou α/β/γ, top DWAs, Neutral Shelf vendor allocation, and per-archetype absorption distribution across the enterprise cohort.
Response: Array<Archetype>
GET/v1/shelf/:archetype
Neutral Shelf — per archetype
Returns the honest multi-vendor slice allocation for one archetype. Example: `/v1/shelf/software-engineering` returns the 6 code-gen slices with OpenAI · Anthropic · Gemini · Human % per slice + volume + confidence tier.
Parameters
| archetype | path | string | Archetype slug |
Response: Shelf
POST/v1/uops/:id/align
Run a UoP through the Alignment Score pipeline
Scores a UoP against the 3-gate Alignment Score (Agent Capability × Org Absorption × Stakeholder Alignment) and returns a composite with per-gate breakdown, ceiling flags, and confidence tier. Idempotent within a 24h window.
Response: AlignmentResult
GET/v1/methodology
The 7-layer methodology as a machine-readable spec
Returns the canonical v1.1 methodology with layer definitions, gate mechanics, dimension weights, and ceiling rules. Use this to render your own methodology surface or to drive a custom Alignment Score composite.
Response: MethodologySpec
