Update a dataset log

PATCH

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

PATCH

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

$ curl -X PATCH 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 }

Partially update a dataset log. Only provided fields are changed.

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.

unique_idstringRequired

Unique log ID within the dataset.

Request

This endpoint expects an object.

inputanyOptional

outputanyOptional

expected_outputanyOptional

promptstringOptional

completionstringOptional

metadataobjectOptional

Response

Updated dataset log.

idstring

Log ID.

unique_idstring

Unique log ID.

organization_idstring

environmentstring

timestampdatetime

start_timedatetime

prompt_tokensinteger

completion_tokensinteger

total_request_tokensinteger

costdouble

modelstring

latencydouble

status_codeinteger

statusstring

metadataobject

promptstring

completionstring

messageslist of objects

inputany

outputany

expected_outputany

dataset_idstring

scoreslist of objects

Errors

401

Unauthorized Error