> Source: https://vitna.ai/docs/api/v1/engine/org-pipeline
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/org-pipeline.md
> Corpus index: https://vitna.ai/llms.txt
# Organisation compound pipeline
Inspect the cross-layer Bill of Materials, bottlenecks, decision-ready switches,
and eligible class-peer exploratory levers across an authenticated
organisation's registered workloads.
```
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:*`](../../../cli/aperture/pipeline.md)
operator command. See
[Multi-class unit profiles and compound pipelines](../../../routing/pipelines.md)
for how stage costs, provenance splits, and optimization tiers are computed.
## Query parameters
| Parameter | Meaning |
|---|---|
| `stages` | Optional comma-separated `<slug>[:<invocationsPerRun>][:bg]` list; defaults to all active workloads in the organisation |
| `monthlyRuns` | Optional positive integer monthly pipeline run count (alias `runs`) |
| `runLabel` | Optional plural unit label for one run (default `runs`) |
| `name` | Optional human-readable pipeline name |
| `discoverPeers` | When `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
}
}
```