---
title: "Batch update experiments"
method: PATCH
path: "/v1/private/experiments/batch"
tags: ["Experiments"]
---

# Batch update experiments

`PATCH /v1/private/experiments/batch`

Update multiple experiments

## Request body

- ExperimentBatchUpdate — Request to batch update multiple experiments
  - `ids` string[], required — List of experiment IDs to update (max 1000)
  - `update` ExperimentUpdate, required
    - `name` string
    - `metadata` JsonNode
    - `tags` string[] — Tags
    - `tags_to_add` string[] — Tags to add
    - `tags_to_remove` string[] — Tags to remove
    - `type` 'regular' | 'trial' | 'mini-batch' | 'mutation'
    - `status` 'running' | 'completed' | 'cancelled' — The status of the experiment
    - `experiment_scores` ExperimentScore[]
      - `name` string, required
      - `value` number, required
  - `merge_tags` boolean — If true, merge tags with existing tags instead of replacing them. Default: false

## Response `204`

No Content

## Other responses

- `400` — Bad Request

---

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