---
title: "POST /api/exploration/thread/{thread-id}/restart"
method: POST
path: "/api/exploration/thread/{thread-id}/restart"
tags: ["/api/exploration"]
---

# POST /api/exploration/thread/{thread-id}/restart

`POST /api/exploration/thread/{thread-id}/restart`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/exploration/thread/{thread-id}/restart`
- Auth: API key in header `X-API-Key`

Re-run one exploration thread in place, keeping its selections: drops the thread's materialized
  queries and clears the terminal-state gates so the background planner re-claims it. Returns the
  parent exploration. Only a terminal thread (completed, failed, or canceled) can restart; while
  planning, execution, or analysis is still in flight this returns a 409 — cancel the thread
  first, then restart.

  No `:event/exploration-update` is published: nothing on the Exploration row changes, so there
  is no revision to record (the revision push skips unchanged objects).

## Path parameters

- `thread-id` integer, required

## Response `2XX`

Successful response

- MetabaseExplorationsApiHydratedExploration: Schema for an Exploration with hydrated creator and threads.
  - `archived` boolean
  - `can_delete` boolean
  - `can_restore` boolean
  - `can_write` boolean
  - `collection_id` integer, nullable: value must be an integer greater than zero.
  - `created_at` unknown
  - `creator` object, nullable
  - `creator_id` integer, required: value must be an integer greater than zero.
  - `description` string, nullable
  - `document` MetabaseExplorationsApiExplorationDocument: Schema for the Summary document attached to an exploration.
    - `archived` boolean
    - `content_type` string, required
    - `created_at` string, date-time, required: value must be a valid date/time/datetime
    - `creator_id` integer, required: value must be an integer greater than zero.
    - `exploration_id` integer, required: value must be an integer greater than zero.
    - `id` integer, required: value must be an integer greater than zero.
    - `is_placeholder` boolean, required
    - `name` string, required
    - `updated_at` string, date-time, required: value must be a valid date/time/datetime
  - `id` integer, required: value must be an integer greater than zero.
  - `name` string, required
  - `threads` MetabaseExplorationsApiHydratedThread[], nullable
    - `blocks` MetabaseExplorationsApiExplorationBlockNode[], nullable
      - `explore_filters` union[], nullable
        - union
          - object
            - `dimension_name` string, nullable
            - `display_value` string, required: value must be a non-blank string.
            - `field_ref` union, required
              - …
            - `operator` '=', required
            - `value` union, required
              - …
          - object
            - `dimension_name` string, nullable
            - `display_value` string, required: value must be a non-blank string.
            - `field_ref` union, required
              - …
            - `operator` 'between', required
            - `values` unknown[], required
              - …
      - `id` integer, required: value must be an integer greater than zero.
      - `name` string, nullable, required
      - `pages` MetabaseExplorationsApiExplorationPageNode[], required
        - `hidden` boolean, required
        - `id` integer, required: value must be an integer greater than zero.
        - `long_name` string, nullable, required
        - `name` string, nullable, required
        - `position` integer, required: value must be an integer greater or equal to than zero.
        - `query_ids` integer[], required
        - `starred` boolean, required
      - `position` integer, required: value must be an integer greater or equal to than zero.
    - `canceled_at` unknown
    - `completed_at` unknown
    - `exploration_id` integer, required: value must be an integer greater than zero.
    - `id` integer, required: value must be an integer greater than zero.
    - `position` integer, required: value must be an integer greater or equal to than zero.
    - `prompt` string, nullable
    - `queries` MetabaseExplorationsApiExplorationQuerySummary[], nullable
      - `card_id` integer, required: value must be an integer greater than zero.
      - `contextual_interestingness_score` number, nullable
      - `dimension_id` string, nullable, required
      - `dimension_name` string
      - `display` string, nullable
      - `entity_id` string, nullable
      - `error_message` string, nullable
      - `exploration_thread_id` integer, required: value must be an integer greater than zero.
      - `finished_at` unknown
      - `id` integer, required: value must be an integer greater than zero.
      - `interestingness_score` number, nullable
      - `name` string, nullable
      - `position` integer, required: value must be an integer greater or equal to than zero.
      - `query_type` string, required
      - `row_count` integer, nullable: value must be an integer greater or equal to than zero.
      - `segment_id` integer, nullable: value must be an integer greater than zero.
      - `segment_name` string, nullable
      - `started_at` unknown
      - `status` string, required
    - `source_page_id` integer, nullable: value must be an integer greater than zero.
    - `started_at` unknown
    - `status` 'pending' | 'running' | 'canceled' | 'empty' | 'failed' | 'completed' | 'forbidden', required
    - `timelines` object[], nullable
      - `position` integer: value must be an integer greater or equal to than zero.
      - `timeline` object, nullable
      - `timeline_id` integer, required: value must be an integer greater than zero.
  - `updated_at` unknown

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/exploration/thread/:thread-id/restart/post.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)