---
title: "Changes to Create an experiment"
method: POST
path: "/v2/experiments"
---

# Changes to Create an experiment

`POST /v2/experiments`

> Every recorded change to this operation, newest first.
> 49 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 49 revisions.

- **2026-09-02** `cb1b01872ec4`: 1 breaking
- **2026-08-28** `f63ac334fd4a`: 1 warning
- **2026-08-12** `1103033ea050`: 2 breaking
- **2026-08-06** `4f94eb2fd1ab`: 4 breaking, 9 info

## Changes

- **2026-09-02** `cb1b01872ec4`: 1 breaking
  - the `experiment_runs` request property's minItems was increased to `1`
- **2026-08-28** `f63ac334fd4a`: 1 warning
  - the `name` request property's maxLength was set to `255`
- **2026-08-12** `1103033ea050`: 2 breaking
  - the `name` request property's minLength was increased from `0` to `1`
  - added the pattern `^[^"\\]*$` to the request property `name`
- **2026-08-06** `4f94eb2fd1ab`: 4 breaking, 9 info
  - the response property `dataset_id` became nullable for the status `201`
  - the response property `dataset_version_id` became nullable for the status `201`
  - the response property `dataset_id` became optional for the status `201`
  - the response property `dataset_version_id` became optional for the status `201`
  - api operation id `experiments_create` removed and replaced with `create_experiment`
  - added the new optional request property `space_id`
  - the request property `dataset_id` became nullable
  - the request property `experiment_runs/items/example_id` became nullable
  - the request property `dataset_id` became optional
  - the request property `experiment_runs/items/example_id` became optional
  - added the non-success response with the status `404`
  - added the optional property `integration_id` to the response with the `201` status
  - added the required property `space_id` to the response with the `201` status

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/experiments/post.md) - [API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [Page](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/experiments/post)