> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pioneer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dataset management API — list, inspect, and delete

> List all datasets in your Pioneer account, inspect version history and example counts, and delete datasets you no longer need. Storage is free on all plans.

Datasets are the foundation of every fine-tuning workflow on Pioneer. You create them through the synthetic data generation API or by uploading your own files, and Pioneer stores them at no cost. Use these endpoints to list your available datasets, inspect their versions, and delete datasets you no longer need.

<Note>
  Datasets are created via `POST /generate` or by uploading files directly. To start training, a dataset must be in the **ready** state.
</Note>

***

## List all datasets

`GET /felix/datasets`

Returns all datasets associated with your account.

```bash theme={null}
curl https://api.pioneer.ai/felix/datasets \
  -H "X-API-Key: YOUR_API_KEY"
```

**Response**

<ResponseField name="success" type="boolean">
  `true` on success.
</ResponseField>

<ResponseField name="count" type="number">
  Total number of datasets returned.
</ResponseField>

<ResponseField name="datasets" type="object[]">
  Array of dataset objects.

  <Expandable title="dataset properties">
    <ResponseField name="dataset_name" type="string">
      Unique dataset name used to reference it in training jobs.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current dataset state. Values: `initialized`, `uploading`, `converting`,`validating`, `ready`, `failed`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the dataset was created.
    </ResponseField>

    <ResponseField name="version_number" type="string">
      Version identifier for this dataset entry.
    </ResponseField>
  </Expandable>
</ResponseField>

## Get dataset versions and details

`GET /felix/datasets/:name`

Returns version history and metadata for a specific dataset.

**Path parameters**

<ParamField path="name" type="string" required>
  The dataset name exactly as it appears in your account.
</ParamField>

```bash theme={null}
curl https://api.pioneer.ai/felix/datasets/my-ner-dataset \
  -H "X-API-Key: YOUR_API_KEY"
```

**Response**

<ResponseField name="success" type="boolean">
  `true` on success.
</ResponseField>

<ResponseField name="count" type="number">
  Number of versions returned.
</ResponseField>

<ResponseField name="versions" type="object[]">
  List of dataset versions, most recent first.

  <Expandable title="version properties">
    <ResponseField name="id" type="string">
      Unique identifier for this version.
    </ResponseField>

    <ResponseField name="dataset_name" type="string">
      Dataset name shared across all versions.
    </ResponseField>

    <ResponseField name="version_number" type="string">
      Version label (e.g. `"1"`, `"2"`).
    </ResponseField>

    <ResponseField name="size" type="number">
      Number of examples in this version.
    </ResponseField>

    <ResponseField name="status" type="string">
      Version state: `initialized`, `uploading`, `converting`, `validating`, `ready`, `failed`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 creation timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

## Delete a dataset

`DELETE /felix/datasets/:name`

Permanently deletes a dataset and all its versions. This action cannot be undone.

<Warning>
  Deleting a dataset does not affect training jobs that have already completed using it, but you will not be able to retrain or run new evaluations with the deleted dataset.
</Warning>

**Path parameters**

<ParamField path="name" type="string" required>
  The name of the dataset to delete.
</ParamField>

```bash theme={null}
curl -X DELETE https://api.pioneer.ai/felix/datasets/my-ner-dataset \
  -H "X-API-Key: YOUR_API_KEY"
```

**Response**

Returns `200` with an empty body on success.