v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
datasets

Create Dataset Log

Create a single dataset log from unified format data

Endpoint: POST /api/datasets/{dataset_id}/logs/ - Create individual dataset log

Args (POST body - unified format): - input (any): The input data (messages, text, etc.) - output (any): The output data (response, completion, etc.) - metadata (object, optional): Additional metadata fields (model, log_type, etc.) - metrics (object, optional): Metric fields (tokens, cost, latency, etc.)

Note: model and log_type can be provided either as top-level fields or within metadata object

Returns (POST 201): { "message": "Dataset log created successfully", "unique_id": "log-123..." }

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

Path parameters

dataset_idstring required

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

{"stackTrail":"components:schemas:DatasetLogCreateRequestRequest:properties:input","oasType":"schema","type":"unknown","description":"Any type"}
{"stackTrail":"components:schemas:DatasetLogCreateRequestRequest:properties:output","oasType":"schema","type":"unknown","description":"Any type"}
{"stackTrail":"components:schemas:DatasetLogCreateRequestRequest:properties:metadata","oasType":"schema","type":"unknown","description":"Any type"}
{"stackTrail":"components:schemas:DatasetLogCreateRequestRequest:properties:metrics","oasType":"schema","type":"unknown","description":"Any type"}

Response

messagestring required
unique_idstring required