---
title: "Add a single pair to a dataset (creates new dataset if the system_prompt_template that's provided doesn't correspond to an existing dataset)"
method: POST
path: "/data/seed/pair"
---

# Add a single pair to a dataset (creates new dataset if the system_prompt_template that's provided doesn't correspond to an existing dataset)

`POST /data/seed/pair`

## Request body

- object
  - `id` string — Optional ID for the pair, will be generated if not provided
  - `input` string, required
  - `output` string, required
  - `labels` string[]
  - `input_media` string, byte — Optional base64 encoded media data
  - `system_prompt_template` string, required — If this prompt already exists, the pair will be added to the existing dataset. If not, a new dataset will be created.

## Response `200`

Pair successfully added to dataset (existing or newly created)

- object
  - `dataset_id` string
  - `pair_id` string

## Other responses

- `400` — Invalid request - missing required fields

## Changes

- **2025-06-30** `9025b1bd86d0` — 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/data/seed/pair/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/f332cf4d71d4/schema)