---
title: "Update Experiment"
method: PUT
path: "/api/experiment"
tags: ["Experiment"]
---

# Update Experiment

`PUT /api/experiment`

Update an experiment. Auth'ed user must be an owner of the organization to update an experiment.

## Headers

- `TR-Dataset` string, uuid, required

## Request body

- UpdateExperimentReqBody
  - `experiment_config` ExperimentConfig
    - `area` string, required
    - `control_name` string, required
    - `control_split` number, float, required
    - `t1_name` string, required
    - `t1_split` number, float, required
  - `id` string, uuid, required
  - `name` string, nullable

## Response `200`

Experiment updated successfully

- Experiment
  - `area` string, required
  - `control_name` string, required
  - `control_split` number, float, required
  - `created_at` string, date-time, required
  - `dataset_id` string, uuid, required
  - `id` string, uuid, required
  - `name` string, required
  - `t1_name` string, required
  - `t1_split` number, float, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Service error relating to updating the experiment

## Changes

- **2025-05-20** `d2cbcee1d6cd` — 1 breaking, 1 info
  - added the new required request property `experiment_config/allOf[#/components/schemas/ExperimentConfig]/area`
  - added the required property `area` to the response with the `200` status
- **2025-05-17** `38d9edf24348` — 1 info
  - endpoint added
- **2025-04-24** `661f8d6f359b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/devflowinc/apis/trieve-api/changes/api/experiment/put.md)

---

[API](https://skmtc.dev/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.dev/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/revisions/84583e7c9fc1/schema)