---
title: "Create dataset items from spans"
method: POST
path: "/v1/private/datasets/{dataset_id}/items/from-spans"
tags: ["Datasets"]
---

# Create dataset items from spans

`POST /v1/private/datasets/{dataset_id}/items/from-spans`

Create dataset items from spans with enriched metadata

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- CreateDatasetItemsFromSpansRequest
  - `span_ids` string[], required — Set of span IDs to add to the dataset
  - `enrichment_options` SpanEnrichmentOptions, required — Options for enriching span data
    - `includeTags` boolean
    - `includeFeedbackScores` boolean
    - `includeComments` boolean
    - `includeUsage` boolean
    - `includeMetadata` boolean
  - `evaluators` EvaluatorItem[] — Optional evaluators to apply to the created items
    - `name` string, required
    - `type` 'llm_judge' | 'code_metric', required
    - `config` JsonNode, required
  - `execution_policy` ExecutionPolicy
    - `runs_per_item` integer
    - `pass_threshold` integer
  - `field_mappings` object — Optional mapping of dataset item field name to a path into the span, e.g. 'input.input_text'. Takes precedence over the fields produced by enrichment_options. Ignored for test suite datasets.

## Response `204`

No content

## Changes

- **2026-09-21** `7e9b9ca95d8f` — 1 info
  - added the new optional request property `field_mappings`

[Change history](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/private/datasets/:dataset_id/items/from-spans/post.md)

---

[API](https://skmtc.dev/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.dev/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/comet-ml/apis/opik-rest-api/revisions/7e9b9ca95d8f?raw)