---
title: "Import Dataset From Import History"
method: POST
path: "/datasets/{dataset_id}/import"
tags: ["datasets"]
---

# Import Dataset From Import History

`POST /datasets/{dataset_id}/import`

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- ImportHistoryDataset
  - `history_id` string, uuid, required — The ID of the import history to import from
  - `mapping` DatasetMapping, required
    - `fields` DatasetMappingItem[], required
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `metadata` DatasetMappingItem[], nullable
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `suggestions` DatasetMappingItem[], nullable
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `source_id` string, nullable — Dataset-level source identifier (format: import:{import_id}, dataset:{dataset_id}, hub:{repo_id})
    - `target_id` string, nullable — Dataset-level target identifier for workflow tracking

## Response `202`

Successful Response

- Job
  - `id` string, required
  - `status` 'created' | 'queued' | 'finished' | 'failed' | 'started' | 'deferred' | 'scheduled' | 'stopped' | 'canceled', required — The Status of Job within its lifecycle at any given time.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/versions/3ebd7ae94c89/schema)