Create a dataset | Respan Docs

Create a new dataset, either empty or populated from existing spans using filters and sampling.

This endpoint expects an object.

namestringRequired

Dataset name.

descriptionstringOptional

Dataset description.

samplingintegerOptionalDefaults to 100

Sampling rate (0-1). Fraction of matching spans to include.

start_timestringOptional

Start of time range for selecting spans (ISO 8601).

end_timestringOptional

End of time range for selecting spans (ISO 8601).

is_emptybooleanOptional

Create an empty dataset (no initial spans).

initial_log_filtersobjectOptional

Filters for selecting initial spans. Same format as Filters API.

Created dataset.

idstring

Dataset ID.

namestring

Dataset name.

descriptionstring

Dataset description.

typestring

Dataset type.

statusenum

Dataset status.

Allowed values:

log_countinteger

Number of spans in the dataset.

created_atdatetime

Creation timestamp.

401

Unauthorized Error

1	curl -X POST https://api.respan.ai/api/datasets/ \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "customer-support-logs"
6	}'

1	{
2	"id": "d4f8a9b2-3c7e-4f1a-9b6d-2e5f7a8c9d01",
3	"name": "customer-support-logs",
4	"description": "Dataset containing spans from customer support interactions collected in March 2024.",
5	"type": "span-collection",
6	"status": "ready",
7	"log_count": 15234,
8	"created_at": "2024-04-10T14:22:00Z"
9	}