API ReferenceDatasets

Create a dataset

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

Authentication

AuthorizationBearer

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.

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Request

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.
granularityenumOptionalDefaults to logs
Evaluation unit. Immutable after dataset creation.
Allowed values:

Response

Dataset created.
idstringOptional
namestringOptional
descriptionstringOptional
typestringOptional
statusenumOptional
initial_log_filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

created_atdatetimeOptional
updated_atdatetimeOptional
granularityenumOptionalRead-onlyDefaults to logs
Evaluation unit. Immutable after dataset creation.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
404
Not Found Error