> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Add an item"
description: "Add a single item to a dataset's draft by hand."
method: "POST"
endpoint: "/api/v1/projects/:projectId/datasets/:id/examples"
order: 9
group: "Draft items"
last_verified: 2026-07-27
---



`POST /api/v1/projects/:projectId/datasets/:id/examples`

Add a single item to a dataset's draft by hand.


  #### Body parameters
  - `input` _object_ **required** — The item's input payload.
  - `expected_output` _object_ — The expected output for scoring.
  - `metadata` _object_ — Arbitrary JSON metadata.