---
title: "Create and execute experiment"
method: POST
path: "/v1/private/experiments/execute"
tags: ["Experiments"]
---

# Create and execute experiment

`POST /v1/private/experiments/execute`

Creates experiments for each prompt variant and asynchronously processes all dataset items

## Request body

- ExperimentExecutionRequest
  - `dataset_name` string, required
  - `dataset_version_id` string, uuid
  - `prompts` PromptVariant[], required
    - `model` string, required
    - `messages` Message[], required
      - `role` string, required
      - `content` JsonNode, required
    - `configs` object
    - `prompt_versions` PromptVersionLink[]
      - `id` string, uuid, required
      - `commit` string
      - `version_number` string — sequential version number in the format v<N>; null for masks
      - `prompt_id` string, uuid
      - `prompt_name` string
  - `project_name` string
  - `dataset_id` string, uuid, required
  - `version_hash` string
  - `prompt_versions` PromptVersionLink[]
    - `id` string, uuid, required
    - `commit` string
    - `version_number` string — sequential version number in the format v<N>; null for masks
    - `prompt_id` string, uuid
    - `prompt_name` string

## Response `202`

Experiments created and processing started

- ExperimentExecutionResponse
  - `experiments` ExperimentInfo[]
    - `experiment_id` string, uuid
    - `prompt_index` integer
  - `total_items` integer

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)