---
title: "Create Experiment"
method: POST
path: "/api/experiment"
tags: ["Experiment"]
---

# Create Experiment

`POST /api/experiment`

Experiment will be created in the dataset specified via the TR-Dataset header. Auth'ed user must be an owner of the organization to create an experiment.

## Headers

- `TR-Dataset` string, uuid, required

## Request body

- CreateExperimentReqBody
  - `experiment_config` ExperimentConfig, required
    - `area` string, required
    - `control_name` string, required
    - `control_split` number, float, required
    - `t1_name` string, required
    - `t1_split` number, float, required
  - `name` string, required

## Response `200`

Experiment created 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 creating the experiment

---

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