vitna.ai/docs/api/v1/engine/org-pipeline Machine view
Raw .md llms.txt
> 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
  }
}
```
Human Machine Shift+M