Update a dataset log | Respan Docs

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

{
  "id": "888d342383e844e185e9cd80b63e4eb1",
  "unique_id": "888d342383e844e185e9cd80b63e4eb1",
  "organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
  "environment": "prod",
  "timestamp": "2025-10-06T02:17:58.639822Z",
  "start_time": "2025-10-06T02:17:58.639822Z",
  "prompt_tokens": 415,
  "completion_tokens": 12,
  "total_request_tokens": 427,
  "cost": 0.0002285,
  "model": "gpt-4o-mini",
  "latency": 0.451,
  "status_code": 200,
  "status": "success",
  "metadata": {
    "provider": "azure_openai"
  },
  "prompt": "Full prompt text here...",
  "completion": "Full completion text here...",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "dataset_id": "6dee217e-18c6-468e-ab6d-7b97e2115752",
  "scores": []
}

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

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

Path parameters

Headers

Request

Response

Errors