---
title: "Initialize import extract"
method: POST
path: "/import/datasets/{id}/extract"
tags: ["Import Datasets"]
---

# Initialize import extract

`POST /import/datasets/{id}/extract`

Manually initialize an extract for an import dataset.

## Path parameters

- `id` string, required

## Request body

- InitializeExtractRequest
  - `filter` union
    - object
      - `type` 'last_modified', required
      - `last_modified` LastModifiedFilter, required
        - `start` string, date-time
        - `end` string, date-time
    - object
      - `type` 'records', required
      - `records` RecordsFilter, required
        - `record_ids` string[], required

## Response `200`

OK

- object
  - `status` 'success', required
  - `data` InitializeExtractResponse, required
    - `extract` ExtractResource, required
      - `id` string, required
      - `dataset_id` string, required
      - `submitted_at` string, required
      - `started_at` string, date-time
      - `ended_at` string, date-time
      - `records_processed` integer
      - `records_existing_updated` integer
      - `records_existing_unchanged` integer
      - `records_existing_deleted` integer
      - `records_new_inserted` integer
      - `records_errored` integer
      - `error` ErrorResource
        - `error_code` string, required
        - `title` string, required
        - `blame` string, required
        - `documentation_url` string, required
        - `trace` string, required
        - `message` string, required
  - `message` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/prequel/apis/prequel-data-export.md) · [All operations](https://skmtc.net/prequel/apis/prequel-data-export/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prequel/prequel-data-export/versions/09c662a871f8/schema)