> 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
---

<ApiEndpoint method="POST" endpoint="/api/v1/projects/:projectId/datasets/:id/examples" description="Add a single item to a dataset's draft by hand.">
  <section>
    #### Body parameters
    <ApiAttribute name="input" type="object" description="The item's input payload." required={true} />
    <ApiAttribute name="expected_output" type="object" description="The expected output for scoring." required={false} />
    <ApiAttribute name="metadata" type="object" description="Arbitrary JSON metadata." required={false} />
  </section>
</ApiEndpoint>