Create a dataset log

POST

https://api.respan.ai/api/datasets/:dataset_id/logs/

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

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. Use _saved_logs for the virtual saved-logs collection.

Request

This endpoint expects an object.

inputanyRequired

outputanyOptional

metadataobjectOptional

metricsobjectOptional

Response

Dataset log created.

messagestring

unique_idstring

Errors

401

Unauthorized Error

$	curl -X POST https://api.respan.ai/api/datasets/dataset_id/logs/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"input": {
>	"customer_id": "cust_12345",
>	"message": "I need help with my subscription"
>	},
>	"output": {
>	"response": "I would be happy to help with your subscription."
>	},
>	"metadata": {
>	"model": "gpt-4o",
>	"log_type": "chat"
>	},
>	"metrics": {
>	"prompt_tokens": 25,
>	"completion_tokens": 18,
>	"cost": 0.002,
>	"latency": 1.8
>	}
>	}'

1	{
2	"message": "Dataset log created successfully",
3	"unique_id": "2844b4f401854250aec6ee1ffd8f38be"
4	}