---
title: "Update Experiment"
method: PATCH
path: "/api/v2/experiments/{experiment_id}/"
tags: ["experiments"]
---

# Update Experiment

`PATCH /api/v2/experiments/{experiment_id}/`

PATCH handler with superadmin lock and field protection.

Checks:
1. Object lock (is_managed=True -> non-superadmins can't modify)
2. Field protection (non-superadmins can't modify specific fields)

## Path parameters

- `experiment_id` string, required

## Headers

- `Authorization` string, required

## Request body

- PatchedExperimentV2UpdateRequest — Write serializer for PATCH /api/v2/experiments/{id}/. The view blocks PATCH while the experiment has a run in flight so the Celery worker never races a mutating write. Ownership fields (`created_by`, `organization`) are immutable after creation.
  - `name` string
  - `description` string
  - `dataset` string, nullable
  - `workflow` unknown
  - `evaluator_slugs` string[] — List of evaluators to run for producing scores for comparison
  - `evaluator_workflow_ids` string[] — List of WorkflowVersion IDs (eval_only) defining evaluator pipelines. Mutually exclusive with evaluator_slugs.
  - `batch_size` integer
  - `concurrency` integer
  - `enable_tracing` boolean
  - `is_starred` boolean

## Response `200`

- ExperimentV2Update — Write serializer for PATCH /api/v2/experiments/{id}/. The view blocks PATCH while the experiment has a run in flight so the Celery worker never races a mutating write. Ownership fields (`created_by`, `organization`) are immutable after creation.
  - `name` string
  - `description` string
  - `dataset` string, nullable
  - `workflow` unknown
  - `evaluator_slugs` string[] — List of evaluators to run for producing scores for comparison
  - `evaluator_workflow_ids` string[] — List of WorkflowVersion IDs (eval_only) defining evaluator pipelines. Mutually exclusive with evaluator_slugs.
  - `batch_size` integer
  - `concurrency` integer
  - `enable_tracing` boolean
  - `is_starred` boolean

---

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