---
title: "Create a ground truth dataset"
method: POST
path: "/v1/quality/ground-truth"
tags: ["Benchmarks"]
---

# Create a ground truth dataset

`POST /v1/quality/ground-truth`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/quality/ground-truth`
- Auth: HTTP bearer

## Request body

- GroundTruthDatasetCreateRequest
  - `name` string, required: Dataset name. Required, non-empty.
  - `description` string: Optional free-text description.

## Response `200`

Dataset created (alias of 201).

- GroundTruthDatasetResponse
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `user_schema_id` string, uuid, nullable
  - `document_count` integer, nullable
  - `created_at` string, date-time
  - `links` object
    - `self` string

## Other responses

- `201`: Dataset created.
- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)