Import existing logs into a dataset

Import existing request logs into a dataset asynchronously using a time range, filters, and optional sampling.

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

Path parameters

dataset_idstringRequired
Dataset ID.

Request

This endpoint expects an object.
start_timedatetimeRequired
end_timedatetimeRequired
filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

sampling_percentageintegerOptionalDefaults to 100

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

Response

Import started.
messagestring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error