4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB

datasets

Create a dataset log

Create a single dataset log from unified-format input/output data.

post/api/datasets/{dataset_id}/logs/

Path parameters

dataset_idstring required

Dataset ID. Use _saved_logs for the virtual saved-logs collection.

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

metadataobject

Additional context for this log, such as category, model, or log type.

metricsobject

Numeric or structured measurements, such as token counts, cost, or latency.

Response

Dataset log created.

messagestring required

unique_idstring required