Get started

Organisation compound pipeline

Source

Inspect the cross-layer Bill of Materials, bottlenecks, decision-ready switches, and eligible class-peer exploratory levers across an authenticated organisation's registered workloads.

text
GET /api/v1/org/pipeline
bash
curl "https://vitna.ai/api/v1/org/pipeline?stages=web-search:6,doc-parse:10,deep-research:1&monthlyRuns=10000&discoverPeers=true" \
  -H "Authorization: Bearer vitna_key_..."

Accepts either an organisation platform key (vitna_key_...) or push key (vitna_push_...). Queries aperture.* and witness.* through the read-only site role (vitna_site) and mutates nothing: every migration or peer evaluation recommendation emits the exact `aperture:*` operator command. See Multi-class unit profiles and compound pipelines for how stage costs, provenance splits, and optimization tiers are computed.

Query parameters

ParameterMeaning
stagesOptional comma-separated <slug>[:<invocationsPerRun>][:bg] list; defaults to all active workloads in the organisation
monthlyRunsOptional positive integer monthly pipeline run count (alias runs)
runLabelOptional plural unit label for one run (default runs)
nameOptional human-readable pipeline name
discoverPeersWhen true, scan active Witness SKUs in each stage's component class for eligible lower-cost exploratory levers

Response shape

json
{
  "orgId": "convexity",
  "orgName": "Convexity",
  "pipeline": {
    "id": "convexity/pipeline",
    "name": "Convexity compound pipeline",
    "orgId": "convexity",
    "runLabel": "runs",
    "monthlyRuns": 10000,
    "stageCount": 3,
    "criticalPathStageCount": 3
  },
  "totals": {
    "costPerRunUsd": 0.094,
    "monthlyCostUsd": 940,
    "annualCostUsd": 11280,
    "pricedStageCount": 3,
    "unpricedStageCount": 0,
    "measuredQualityStageCount": 3,
    "compoundSuccessRatePct": 91.2,
    "strictAllCallsSuccessRatePct": 84.5,
    "costPerSuccessfulRunUsd": 0.10307,
    "criticalPathLatencyP90Ms": 2840,
    "latencyComplete": true
  },
  "breakdown": { ... },
  "bottlenecks": { ... },
  "optimization": { ... },
  "stages": [ ... ],
  "runAttribution": null,
  "caveats": [ ... ],
  "recommendedCommands": [ ... ],
  "sentence": "Pipeline Convexity compound pipeline costs $0.094000 per run ($940.00/mo across 10,000 runs) across 3 priced stages; ...",
  "meta": {
    "generatedAt": "2026-11-06T00:00:00.000Z",
    "stageCount": 3,
    "discoverPeers": true
  }
}