---
title: "Create Experiment Trial Endpoint"
method: POST
path: "/v1/strategies/{strategy_id}/experiments/{experiment_id}/trials"
tags: ["strategies"]
---

# Create Experiment Trial Endpoint

`POST /v1/strategies/{strategy_id}/experiments/{experiment_id}/trials`

## 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}/trials`
- Auth: none declared

Create one concrete attempt to evaluate or apply an experiment.

## Path parameters

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

## Headers

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

## Request body

- ExperimentTrialCreateRequest
  - `trial_kind` 'analysis_only' | 'parameter_edit' | 'structural_edit' | 'universe_edit' | 'risk_control', nullable
  - `status` 'proposed' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'archived'
  - `experiment_plan_artifact_id` string, nullable
  - `diff_artifact_id` string, nullable
  - `control_commit_id` string, nullable
  - `candidate_commit_id` string, nullable
  - `control_backtest_id` string, nullable
  - `candidate_backtest_id` string, nullable
  - `source_hash_before` string, nullable
  - `source_hash_after` string, nullable
  - `metrics_delta` object, nullable
  - `result_summary` string, nullable

## Response `201`

Successful Response

- ExperimentTrialResponse
  - `trial_id` string, required
  - `org_id` string, required
  - `strategy_id` string, required
  - `experiment_id` string, required
  - `trial_kind` string, required
  - `status` string, required
  - `created_by_run_id` string, nullable
  - `experiment_plan_artifact_id` string, nullable
  - `diff_artifact_id` string, nullable
  - `control_commit_id` string, nullable
  - `candidate_commit_id` string, nullable
  - `control_backtest_id` string, nullable
  - `candidate_backtest_id` string, nullable
  - `source_hash_before` string, nullable
  - `source_hash_after` string, nullable
  - `metrics_delta` object
  - `result_summary` string, nullable
  - `decision` string, nullable
  - `decision_rationale` string, nullable
  - `created_at` string, required
  - `updated_at` string, required

## 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)