Replace a dataset log

PUT

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

PUT

/api/datasets/:dataset_id/logs/:unique_id/

$ curl -X PUT https://api.respan.ai/api/datasets/dataset_id/logs/unique_id/ \
>      -H "Authorization: Bearer <respanApiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "output": {
>     "response": "UPDATED: Go to Settings > Security > Change Password.",
>     "confidence": 0.99,
>     "updated": true
>   }
> }'

1 {
2   "id": "888d342383e844e185e9cd80b63e4eb1",
3   "unique_id": "888d342383e844e185e9cd80b63e4eb1",
4   "organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
5   "environment": "prod",
6   "timestamp": "2025-10-06T02:17:58.639822Z",
7   "start_time": "2025-10-06T02:17:58.639822Z",
8   "prompt_tokens": 415,
9   "completion_tokens": 12,
10   "total_request_tokens": 427,
11   "cost": 0.0002285,
12   "model": "gpt-4o-mini",
13   "latency": 0.451,
14   "status_code": 200,
15   "status": "success",
16   "metadata": {
17     "provider": "azure_openai"
18   },
19   "prompt": "Full prompt text here...",
20   "completion": "Full completion text here...",
21   "messages": [
22     {
23       "role": "user",
24       "content": "Hello"
25     }
26   ],
27   "dataset_id": "6dee217e-18c6-468e-ab6d-7b97e2115752",
28   "scores": []
29 }

Replace a dataset log with a new payload. Fields omitted from the body are removed.

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, 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.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

dataset_idstringRequired

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

unique_idstringRequired

Unique log ID within the dataset.

Request

This endpoint expects an object.

inputanyOptional

outputanyOptional

expected_outputanyOptional

promptstringOptional

completionstringOptional

metadataobjectOptional

error_codestringOptional<=120 characters

error_messagestringOptional

Response

Updated dataset log.

idstringOptional

Log ID.

unique_idstringOptional

Unique log ID.

organization_idstringOptional

environmentstringOptional

timestampdatetimeOptional

start_timedatetimeOptional

prompt_tokensintegerOptional

completion_tokensintegerOptional

total_request_tokensintegerOptional

costdoubleOptional

modelstringOptional

latencydoubleOptional

status_codeintegerOptional

statusstringOptional

metadataobjectOptional

promptstringOptional

completionstringOptional

messageslist of objectsOptional

inputanyOptional

outputanyOptional

expected_outputanyOptional

dataset_idstringOptional

scoreslist of objectsOptional

error_codestringOptional<=120 characters

error_messagestringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error