---
title: "Patch Experiment"
method: PATCH
path: "/v1/strategies/{strategy_id}/experiments/{experiment_id}"
tags: ["strategies"]
---

# Patch Experiment

`PATCH /v1/strategies/{strategy_id}/experiments/{experiment_id}`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/strategies/{strategy_id}/experiments/{experiment_id}`
- Auth: none declared

Update queue metadata, status, or decision fields for one experiment.

## Path parameters

- `strategy_id` string, required
- `experiment_id` string, required

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Request body

- ExperimentPatchRequest
  - `description` string, nullable
  - `status` 'proposed' | 'queued' | 'selected' | 'running' | 'completed' | 'accepted' | 'rejected' | 'inconclusive' | 'stale' | 'archived', nullable
  - `experiment_type` 'analysis_only' | 'cost' | 'parameter_edit' | 'robustness' | 'structural_edit' | 'universe_edit' | 'risk_control', nullable
  - `hypothesis` string, nullable
  - `proposed_change` string, nullable
  - `expected_tradeoff` string, nullable
  - `success_criteria` string, nullable
  - `priority_rank` integer, nullable
  - `decision` 'accept' | 'reject' | 'revise' | 'keep_observing' | 'defer', nullable
  - `decision_rationale` string, nullable
  - `archived_reason` string, nullable

## Response `200`

Successful Response

- ExperimentResponse
  - `experiment_id` string, required
  - `org_id` string, nullable
  - `strategy_id` string, required
  - `name` string, required
  - `description` string, nullable
  - `status` string, required
  - `base_commit_id` string, nullable
  - `objective_metric` string, nullable
  - `kind` string
  - `experiment_type` string, nullable
  - `hypothesis` string, nullable
  - `proposed_change` string, nullable
  - `expected_tradeoff` string, nullable
  - `success_criteria` string, nullable
  - `priority_rank` integer, nullable
  - `source_hash_at_proposal` string, nullable
  - `control_backtest_id` string, nullable
  - `control_artifact_id` string, nullable
  - `created_by_run_id` string, nullable
  - `selected_at` string, nullable
  - `decided_at` string, nullable
  - `decision` string, nullable
  - `decision_rationale` string, nullable
  - `archived_reason` string, nullable
  - `meta` object, nullable
  - `created_at` string, required
  - `updated_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usekeel/apis/keel-api.md) · [All operations](https://skmtc.dev/usekeel/apis/keel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usekeel/apis/keel-api/revisions/3191ca10b0ab?raw)