---
title: "Create one stored immutable repository decision plan revision"
method: POST
path: "/v1/repositories/{repository_id}/decision-plans"
tags: ["Repository Intelligence"]
---

# Create one stored immutable repository decision plan revision

`POST /v1/repositories/{repository_id}/decision-plans`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/repositories/{repository_id}/decision-plans`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `repository_id` string, uuid, required

## Query parameters

- `async_execution` boolean

## Request body

- RepositoryDecisionPlanCreateRequest
  - `snapshot_id` string, nullable
  - `workspace_evidence_bundle_ref` string, required
  - `model` string, nullable

## Response `200`

Successful Response

- RepositoryDecisionPlanResponse
  - `repository_id` string, required
  - `snapshot_id` string, required
  - `decision_plan_id` string, required
  - `created_at` string, date-time, required
  - `decision_plan` DecisionPlan, required: Structured, LLM-readable summary of the decision output. This is the headline object — it surfaces all decision-critical fields in a compact, consistent shape regardless of simulation model used. Populate ``options`` with all ranked alternatives when using /v1/recommend.
    - `recommended_action` string, required
    - `confidence` number, required
    - `expected_value` number, required
    - `risk` RiskProfile, required: Quantified downside and upside for a single outcome distribution.
      - `p5` number, required: 5th-percentile outcome (downside risk floor)
      - `p95` number, required: 95th-percentile outcome (upside ceiling)
      - `probability_of_loss` number, required: P(outcome < 0)
      - `var_95` number, nullable: Value-at-Risk at 95% confidence
    - `options` DecisionOption[]: All alternatives ranked by expected value. Single-element for simulate, multi for recommend.
      - `name` string, required
      - `rank` integer, required
      - `expected_value` number, required
      - `risk` RiskProfile, required: Quantified downside and upside for a single outcome distribution.
        - `p5` number, required: 5th-percentile outcome (downside risk floor)
        - `p95` number, required: 95th-percentile outcome (upside ceiling)
        - `probability_of_loss` number, required: P(outcome < 0)
        - `var_95` number, nullable: Value-at-Risk at 95% confidence
      - `score` number, nullable: Composite score (0–1)
    - `rationale` string, required
    - `integrity` object, nullable: Cryptographic proof of inputs/outputs: {request_hash, result_hash}.
    - `calibration` string, nullable: Human-readable calibration summary, e.g. '12 outcomes | bias=-8.3% (over-optimistic) | hit_rate=75%'. Null until MIN_SAMPLES (5) outcomes are recorded for this org.
    - `repository_analysis` RepositoryAnalysis: Repository-intelligence extension block for DecisionPlan.
      - `root_cause` string, required
      - `planner_model_id` string, required
      - `planner_execution_mode` string, required
      - `planner_provider_backend` string, nullable
      - `candidate_fixes` string[]
      - `impacted_services` string[]
      - `impacted_symbols` string[]
      - `likely_failing_tests` string[]
      - `rollback_complexity` string, required
      - `blast_radius` string, required
      - `workspace_evidence_refs` string[]
      - `generated_patch_ref` string, nullable
      - `patch_impact_report_ref` string, nullable
      - `token_reduction_metrics` TokenReductionMetrics, required: Token-budget compression produced by deterministic repository narrowing.
        - `raw_repo_token_estimate` integer, required
        - `evidence_bundle_token_count` integer, required
        - `reduction_ratio` number, required
  - `patch_diff` string, nullable
  - `planner_usage` object
  - `agent_run_id` string, nullable
  - `session_id` string, nullable
  - `runtime_kind` string, nullable
  - `is_stub` boolean, nullable
  - `runtime_provider` string, nullable
  - `runtime_model` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)