---
title: "Create Exploration"
method: POST
path: "/api/v2/explorations"
tags: ["Explorations"]
---

# Create Exploration

`POST /api/v2/explorations`

## Request body

- CreateExplorationRequestWithInputPorts
  - `name` string, required
  - `namespace` string, required
  - `description` string, required
  - `domain_id` string, uuid, required
  - `input_ports` RequestInputPortsForExplorationRequest
    - `output_ports` RequestInputPortsForAbstractDataProductRequestItem[], required
      - `output_port_id` string, uuid, required
      - `access_mode_id` string, uuid, nullable
    - `justification` string, required

## Response `200`

Successful Response

- CreateExplorationResponse
  - `id` string, uuid, required
  - `name` string, required
  - `namespace` string, required
  - `description` string, required
  - `domain` Domain, required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, required
  - `status` 'pending' | 'active' | 'archived' | 'deleting', required
  - `finalizers` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-06** `6da4734264a7` — 2 breaking, 1 info
  - added the new required request property `input_ports/anyOf[subschema #1: RequestInputPortsForExplorationRequest]/output_ports/items/output_port_id`
  - the `input_ports/anyOf[subschema #1: RequestInputPortsForExplorationRequest]/output_ports/items/` request property type/format changed from `string`/`uuid` to `object`/``
  - added the new optional request property `input_ports/anyOf[subschema #1: RequestInputPortsForExplorationRequest]/output_ports/items/access_mode_id`
- **2026-06-18** `27bdd30fdd25` — 2 info
  - added the required property `finalizers` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
- **2026-04-28** `290bbbfdb89a` — 1 breaking, 1 info
  - removed `#/components/schemas/CreateInputPortsForExplorationRequest` from the `input_ports` request property `anyOf` list
  - added `#/components/schemas/RequestInputPortsForExplorationRequest` to the `input_ports` request property `anyOf` list
- **2026-04-24** `34f5b4fdde60` — 1 info
  - added the new optional request property `input_ports`
- **2026-04-21** `1d06e4d7ba08` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/conveyordata/apis/data-product-portal/changes/api/v2/explorations/post.md)

---

[API](https://skmtc.dev/conveyordata/apis/data-product-portal.md) · [All operations](https://skmtc.dev/conveyordata/apis/data-product-portal/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conveyordata/data-product-portal/revisions/0210e55aab9d/schema)