---
title: "Grow Dataset"
method: POST
path: "/felix/dataset/grow"
tags: ["felix"]
---

# Grow Dataset

`POST /felix/dataset/grow`

Grow an existing dataset by generating new synthetic examples.

Takes an existing classification or NER dataset and generates additional
examples to reach the target size. Supports class balancing to ensure
equal representation of each class.

Args:
    request: Growth request with dataset ID, target size, and options.
    auth: Authentication result with user ID and client.

Returns:
    GrowDatasetResponse with new dataset info and generation statistics.

Raises:
    HTTPException: If dataset not found, invalid type, or generation fails.

## Request body

- GrowDatasetRequest — Request to grow an existing dataset by generating new examples. Supports both classification and NER datasets. When class_balance is enabled, generates equal examples per class. Otherwise, generates equal examples per source example from the original dataset.
  - `dataset_id` string, required — ID of the existing dataset to grow from
  - `new_dataset_name` string, required — Name for the new grown dataset
  - `target_size` integer, required — Total number of examples in the final dataset
  - `class_balance` boolean — If True, balance classes equally. If False, generate equal examples per source example.
  - `domain_description` string, nullable — Override domain description for generation context
  - `temperature` number — Generation temperature
  - `session_id` string, nullable — Session ID for log streaming

## Response `200`

Successful Response

- GrowDatasetResponse — Response from dataset grow operation.
  - `success` boolean, required — Whether the operation succeeded
  - `dataset` object, required — New dataset info (id, name, path, version)
  - `original_size` integer, required — Number of examples in the original dataset
  - `new_size` integer, required — Total number of examples in the new dataset
  - `generated_count` integer, required — Number of new examples generated
  - `distribution` object, required — Number of examples generated per class/label
  - `token_usage` integer, nullable — Estimated tokens used for generation

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/revisions/31dfe831e079/schema)