---
title: "Update exploration configuration"
method: PUT
path: "/explorations/{exploration_id}/config"
tags: ["Explorations"]
---

# Update exploration configuration

`PUT /explorations/{exploration_id}/config`

## Path parameters

- `exploration_id` string, required

## Query parameters

- `project_id` string, required
- `action` 'start' | 'stop', required

## Request body

- ExplorationConfig — Configuration for the exploration. Specify the columns to be used in the exploration, and any global metrics to be applied.
  - `columns` ColumnConfig[], required
    - `label` string, required — Label of the column
    - `aggregation` AggregationConfig, nullable — Configuration for the column aggregation, if any. Specify the aggregationId to apply a specific aggregation to the column, and add the additional properties needed for that aggregation.
      - `aggregation_id` string — ID of the aggregation to be applied to the column, must be one of the available aggregations
    - `column_metrics` string[], nullable — List of metrics to be applied to the column, must be one of the available column metrics
  - `global_metrics` string[], nullable — List of global metrics to be applied to the exploration, must be one of the available global metrics
  - `column_metrics` ColumnMetricConfig[], nullable — List of metrics to be applied to the columns
    - `column_label` string — Label of the column to which the metric applies
    - `metrics` string[] — List of metrics to be applied to the column, must be one of the available column metrics

## Response `200`

Configuration updated

## Changes

- **2025-06-19** `df21912e3884` — 1 info
  - added the new optional request property `column_metrics`
- **2025-05-15** `f00696d27785` — 1 warning
  - removed the request property `column_metrics`

[Change history](https://skmtc.dev/debiai/apis/exploration-api/changes/explorations/:exploration_id/config/put.md)

---

[API](https://skmtc.dev/debiai/apis/exploration-api.md) · [All operations](https://skmtc.dev/debiai/apis/exploration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/debiai/exploration-api/revisions/9a980d1404db/schema)