Create a dataset | Respan Docs

Create a new dataset from existing logs, create an empty dataset, or duplicate an existing dataset.

This endpoint expects an object.

namestringOptional

Dataset name. Required unless source_dataset_id is provided.

descriptionstringOptional

Dataset description.

samplingintegerOptionalDefaults to 100

Percent of matching logs to add (1-100).

start_timedatetimeOptional

Start of the time range to sample logs from.

end_timedatetimeOptional

End of the time range to sample logs from.

is_emptybooleanOptionalDefaults to false

Create an empty dataset without importing logs.

initial_log_filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

source_dataset_idstringOptional

Existing dataset ID to duplicate. Copies logs asynchronously.

Dataset created.

idstring

namestring

descriptionstring

typestring

statusenum

Allowed values:

initial_log_filtersmap from strings to objects

Platform-standard filters keyed by field name.

created_atdatetime

updated_atdatetime

401

Unauthorized Error

404

Not Found 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": "Support Conversations - July",
6	"description": "Sampled support chats for July",
7	"sampling": 40,
8	"start_time": "2025-07-01T00:00:00Z",
9	"end_time": "2025-07-31T23:59:59Z",
10	"initial_log_filters": {
11	"status_code": {
12	"operator": "eq",
13	"value": 200
14	}
15	}
16	}'

1	{
2	"id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
3	"name": "Custom Workflow Logs",
4	"description": "Manually curated logs for workflow analysis",
5	"type": "sampling",
6	"status": "ready",
7	"initial_log_filters": {},
8	"created_at": "2025-12-09T10:00:00Z",
9	"updated_at": "2025-12-09T10:00:00Z"
10	}