---
title: "Batch create dataset items in next_release version"
method: POST
path: "/api/v1/datasets/{datasetSlug}/items"
tags: ["Datasets"]
---

# Batch create dataset items in next_release version

`POST /api/v1/datasets/{datasetSlug}/items`

## Request

- Base URL: `https://dev.noveum.ai`
- URL: `https://dev.noveum.ai/api/v1/datasets/{datasetSlug}/items`
- Auth: API key in cookie `apiKeyCookie` and HTTP bearer

Creates multiple dataset items that will be added to the dataset's next_release version. These items will become part of the published dataset when you call the publish endpoint.

## Path parameters

- `datasetSlug` string, required

## Request body

- object
  - `items` object[], required
    - `item_id` string
    - `item_type` string, required
    - `content` object, required
      - `agent_name` string
      - `agent_role` string
      - `agent_task` string
      - `agent_response` string
      - `system_prompt` string
      - `user_id` string
      - `session_id` string
      - `turn_id` string
      - `ground_truth` string
      - `expected_tool_call` string
      - `tools_available` unknown[]
        - unknown
      - `tool_calls` unknown[]
        - unknown
      - `tool_call_results` unknown[]
        - unknown
      - `parameters_passed` object
      - `retrieval_query` unknown[]
        - unknown
      - `retrieved_context` unknown[]
        - unknown
      - `exit_status` string
      - `agent_exit` string
      - `conversation_id` string
      - `speaker` string
      - `message` string
      - `conversation_context` object
      - `input_text` string
      - `output_text` string
      - `expected_output` string
      - `evaluation_context` object
      - `criteria` string
      - `quality_score` number
      - `validation_status` string
      - `validation_errors` unknown[]
        - unknown
      - `tags` unknown[]
        - unknown
      - `custom_attributes` object
      - `stt_data` unknown[]
        - unknown
      - `tts_data` object
      - `raw_complete_audio` object
      - `vad_metrics` unknown[]
        - unknown
      - `stt_metrics` unknown[]
        - unknown
      - `tts_metrics` unknown[]
        - unknown
      - `llm_metrics` unknown[]
        - unknown
      - `eou_metrics` unknown[]
        - unknown
      - `latency` object
      - `score_results` union
        - object
        - string
    - `metadata` object
    - `trace_id` string
    - `span_id` string

## Response `200`

Success

- object

## Other responses

- `201`: Items created
- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Dataset not found
- `409`: Conflict
- `422`: Unprocessable entity
- `500`: Internal server error

---

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