Sign in

4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
datasets

Create a dataset

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

post/api/datasets/

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

namestring

Dataset name. Required unless source_dataset_id is provided.

descriptionstring

Dataset description.

samplinginteger

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

start_timestring date-time

Start of the time range to sample logs from.

end_timestring date-time

End of the time range to sample logs from.

is_emptyboolean

Create an empty dataset without importing logs.

initial_log_filtersobject

Platform-standard filters keyed by field name.

source_dataset_idstring

Existing dataset ID to duplicate. Copies logs asynchronously.

granularity'logs' | 'traces'

Evaluation unit. Immutable after dataset creation.

Response

Dataset created.

idstring
namestring
descriptionstring
typestring
status'initializing' | 'ready' | 'failed' | 'loading'
initial_log_filtersobject

Platform-standard filters keyed by field name.

created_atstring date-time
updated_atstring date-time
granularity'logs' | 'traces'

Evaluation unit. Immutable after dataset creation.