v3

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

Update Dataset Log

Retrieve, update, or delete a single dataset log.

Endpoints: GET /api/datasets/{dataset_id}/logs/{log_id}/ - Get complete log details PATCH /api/datasets/{dataset_id}/logs/{log_id}/ - Update log content PUT /api/datasets/{dataset_id}/logs/{log_id}/ - Replace log content DELETE /api/datasets/{dataset_id}/logs/{log_id}/ - Remove log from dataset

Response (GET 200 OK): Complete log object including full input/output text, metadata, metrics, annotation status, evaluation scores, and all other log fields.

Request Body (PATCH/PUT): Any log fields to update (input, output, metadata, etc.)

Response (PATCH/PUT 200 OK): {"message": "Log updated successfully", "unique_id": "log_id"}

Response (DELETE 204 No Content): Empty response body

Errors: - 401 Unauthorized — Missing/invalid authentication - 404 Not Found — Log not found in dataset or dataset not found - 400 Bad Request — Invalid update data

patch/api/datasets/{dataset_id}/logs/{unique_id}/

Path parameters

dataset_idstring required
unique_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

idstring
organization_idstring
unique_organization_idstring
organization_namestring
error_messagestring
{"stackTrail":"components:schemas:PatchedCHDatasetLogRequest:properties:completion_messages","oasType":"schema","type":"unknown","description":"Any type"}
inputstring
outputstring
{"stackTrail":"components:schemas:PatchedCHDatasetLogRequest:properties:variables","oasType":"schema","type":"unknown","description":"Any type"}
temperaturenumber double
max_tokensinteger
top_pnumber double
frequency_penaltynumber double
presence_penaltynumber double
stopstring
{"stackTrail":"components:schemas:PatchedCHDatasetLogRequest:properties:response_format","oasType":"schema","type":"unknown","description":"Any type"}
unit_pricesobject
component_costsobject
dataset_idstring
original_copy_unique_idstring
comparison_keystring
expected_outputstring
custom_identifierstring
group_identifierstring
blurredboolean
start_timestring date-time
timestampstring date-time
load_balance_group_idstring
prompt_tokensinteger
completion_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
total_request_tokensinteger
is_token_count_estimatedinteger
costnumber double
llm_gateway_markup_ratenumber double
service_tierstring
model_discountnumber double
pricing_tierstring
audio_input_filestring
audio_output_filestring
organization_key_idstring
user_emailstring
modelstring
provider_idstring
categorystring
propertiesstring
cache_bitinteger
cache_miss_bitinteger
cache_keystring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
statusstring
has_tool_callsboolean
status_codeinteger
log_methodstring
log_typestring
environmentstring
streamboolean
evaluation_identifierstring
customer_identifierstring
customer_emailstring
customer_namestring
customer_user_unique_idstring
used_custom_credentialboolean
deployment_namestring
deployment_idstring
prompt_namestring
prompt_idstring
prompt_version_numberinteger
system_textstring
prompt_textstring
completion_textstring
prompt_message_countinteger
completion_message_countinteger
trace_unique_idstring
span_unique_idstring
span_namestring
span_parent_idstring
span_workflow_namestring
session_identifierstring
span_linksstring
trace_group_identifierstring
thread_identifierstring
thread_unique_idstring
storage_object_keystring
period_startstring date-time
period_endstring date-time
unique_idstring
respan_gateway_request_idstring
full_textstring

Response

idstring required
input_wordsstring required
output_wordsstring required
input_charsstring required
output_charsstring required
organization_key_namestring required
organization_idstring required
unique_organization_idstring
organization_namestring
error_messagestring
warningsstring required
annotation_statusstring required
keywordsai_paramsstring required
full_requeststring required
full_responsestring required
metadatastring required
toolsstring required
tool_callsstring required
prompt_messagesstring required
completion_messagestring required
{"stackTrail":"components:schemas:CHDatasetLog:properties:completion_messages","oasType":"schema","type":"unknown","description":"Any type"}
inputstring
outputstring
{"stackTrail":"components:schemas:CHDatasetLog:properties:variables","oasType":"schema","type":"unknown","description":"Any type"}
temperaturenumber double
max_tokensinteger
top_pnumber double
frequency_penaltynumber double
presence_penaltynumber double
stopstring
{"stackTrail":"components:schemas:CHDatasetLog:properties:response_format","oasType":"schema","type":"unknown","description":"Any type"}
unit_pricesobject
component_costsobject
dataset_idstring
original_copy_unique_idstring
comparison_keystring
expected_outputstring
custom_identifierstring
group_identifierstring
blurredboolean
start_timestring date-time
timestampstring date-time
load_balance_group_idstring
prompt_tokensinteger
completion_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
total_request_tokensinteger
is_token_count_estimatedinteger
costnumber double
llm_gateway_markup_ratenumber double
service_tierstring
model_discountnumber double
pricing_tierstring
audio_input_filestring
audio_output_filestring
organization_key_idstring
user_emailstring
modelstring
provider_idstring
categorystring
propertiesstring
cache_bitinteger
cache_miss_bitinteger
cache_keystring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
statusstring
has_tool_callsboolean
status_codeinteger
log_methodstring
log_typestring
environmentstring
streamboolean
evaluation_identifierstring
customer_identifierstring
customer_emailstring
customer_namestring
customer_user_unique_idstring
used_custom_credentialboolean
deployment_namestring
deployment_idstring
prompt_namestring
prompt_idstring
prompt_version_numberinteger
system_textstring
prompt_textstring
completion_textstring
prompt_message_countinteger
completion_message_countinteger
trace_unique_idstring
span_unique_idstring
span_namestring
span_parent_idstring
span_workflow_namestring
session_identifierstring
span_linksstring
trace_group_identifierstring
thread_identifierstring
thread_unique_idstring
storage_object_keystring
period_startstring date-time
period_endstring date-time
unique_idstring
respan_gateway_request_idstring
full_textstring