Sign in
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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth 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.

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

Changes