---
title: "Enable to start / stop the exploration"
method: PUT
path: "/explorations/{exploration_id}"
tags: ["Explorations"]
---

# Enable to start / stop the exploration

`PUT /explorations/{exploration_id}`

## Path parameters

- `exploration_id` string, required

## Query parameters

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

## Response `200`

Exploration created

- Exploration — Exploration object representing a data exploration task.
  - `id` string
  - `name` string
  - `description` string
  - `state` 'completed' | 'ongoing' | 'not_started' | 'upcoming'
  - `theoretical_combinations` integer, nullable
  - `real_combinations` integer, nullable
  - `remaining_time` string, date-time, nullable
  - `started_at` string, date-time, nullable
  - `finished_at` string, date-time, nullable
  - `current_sample` integer, nullable
  - `combinaisons` array[], nullable
    - string[]
  - `metrics` object, nullable
  - `combinaisons_file` string, uri

## Changes

> 10 revisions in range; 1 could not be searched.

- **2025-06-17** `4d81f9775513` — 1 info
  - added the optional property `metrics` to the response with the `200` status
- **2025-06-13** `c9d5206deff2` — 1 info
  - added the optional property `finished_at` to the response with the `200` status
- **2025-06-13** `cd0994605b52` — 1 info
  - added the optional property `started_at` to the response with the `200` status
- **2025-06-05** `0f01850f2d08` — 4 warning, 4 info
  - removed the optional property `combinaison` from the response with the `200` status
  - removed the optional property `combinaison_file` from the response with the `200` status
  - removed the optional property `real_computations` from the response with the `200` status
  - removed the optional property `theoretical_computations` from the response with the `200` status
  - …4 more
- **2025-06-05** `2f0c8e2113c1` — 1 info
  - added the new enum value `updateConfig` to the `query` request parameter `action`

[Full history](https://skmtc.dev/debiai/apis/exploration-api/changes/explorations/:exploration_id/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)