---
title: "Augment seed data to generate synthetic data"
method: POST
path: "/augment"
---

# Augment seed data to generate synthetic data

`POST /augment`

## Request body

- object
  - `seed_data_id` string — ID of seed dataset to augment (will use latest if not provided)
  - `multiple` integer — Number of synthetic examples to generate per seed example (max 50)
  - `eval_results_id` string — ID of evaluation results to use for target metric (will use latest if not provided)
  - `pair_query` object — Optional query parameters to filter seed dataset pairs
    - `latest_n_pairs` integer — Maximum number of latest pairs to include (defaults to 150 if not provided)
    - `pair_label` string — Filter pairs by label (optional)
  - `target_metric` string — Target metric for redrafting synthetic data (will use lowest scoring metric if not provided)

## Response `200`

Data successfully augmented

- object
  - `synthetic_data_id` string
  - `created_at` string
  - `seed_data_size` integer
  - `synthetic_data_size` integer
  - `system_prompt` string
  - `target_metric` object

## Changes

- **2025-06-10** `d550ab79ee7e` — 3 info
  - added the new optional request property `pair_query`
  - added the new optional request property `target_metric`
  - the request property `seed_data_id` became optional
- **2025-04-30** `2eb8cb01b88b` — 1 info
  - endpoint added
- **2025-04-30** `9a3d86c43d3d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getplumai/apis/plum-api/changes/augment/post.md)

---

[API](https://skmtc.dev/getplumai/apis/plum-api.md) · [All operations](https://skmtc.dev/getplumai/apis/plum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getplumai/plum-api/revisions/2c7df02e7ab4/schema)