Clickhouse Request Logs Partial Update 2

PATCH

https://api.respan.ai/clickhouse/request-logs/:unique_id/

PATCH

/clickhouse/request-logs/:unique_id/

$ curl -X PATCH https://api.respan.ai/clickhouse/request-logs/unique_id/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

1 {
2   "id": "string",
3   "input_words": "string",
4   "output_words": "string",
5   "input_chars": "string",
6   "output_chars": "string",
7   "organization_key_name": "string",
8   "organization_id": "string",
9   "warnings": "string",
10   "annotation_status": "string",
11   "keywordsai_params": "string",
12   "full_request": "string",
13   "full_response": "string",
14   "metadata": "string",
15   "tools": "string",
16   "tool_calls": "string",
17   "prompt_messages": "string",
18   "completion_message": "string",
19   "unique_organization_id": "string",
20   "organization_name": "string",
21   "error_message": "string",
22   "input": "string",
23   "output": "string",
24   "temperature": 1.1,
25   "max_tokens": 1,
26   "top_p": 1.1,
27   "frequency_penalty": 1.1,
28   "presence_penalty": 1.1,
29   "stop": "string",
30   "matched_meter_ids": [
31     null
32   ],
33   "unit_prices": {},
34   "component_costs": {},
35   "custom_identifier": "string",
36   "group_identifier": "string",
37   "blurred": true,
38   "start_time": "2024-01-15T09:30:00Z",
39   "timestamp": "2024-01-15T09:30:00Z",
40   "load_balance_group_id": "string",
41   "prompt_tokens": 1,
42   "completion_tokens": 1,
43   "prompt_cache_hit_tokens": 1,
44   "prompt_cache_creation_tokens": 1,
45   "reasoning_tokens": 1,
46   "total_request_tokens": 1,
47   "is_token_count_estimated": 1,
48   "cost": 1.1,
49   "llm_gateway_markup_rate": 1.1,
50   "service_tier": "string",
51   "model_discount": 1.1,
52   "pricing_tier": "string",
53   "audio_input_file": "string",
54   "audio_output_file": "string",
55   "organization_key_id": "string",
56   "user_email": "string",
57   "model": "string",
58   "provider_id": "string",
59   "category": "string",
60   "properties": "string",
61   "cache_bit": 1,
62   "cache_miss_bit": 1,
63   "cache_key": "string",
64   "latency": 1.1,
65   "tokens_per_second": 1.1,
66   "time_to_first_token": 1.1,
67   "routing_time": 1.1,
68   "status": "string",
69   "has_tool_calls": true,
70   "status_code": 1,
71   "log_method": "string",
72   "log_type": "string",
73   "environment": "string",
74   "stream": true,
75   "evaluation_identifier": "string",
76   "customer_identifier": "string",
77   "customer_email": "string",
78   "customer_name": "string",
79   "customer_user_unique_id": "string",
80   "used_custom_credential": true,
81   "deployment_name": "string",
82   "deployment_id": "string",
83   "prompt_name": "string",
84   "prompt_id": "string",
85   "prompt_version_number": 1,
86   "system_text": "string",
87   "prompt_text": "string",
88   "completion_text": "string",
89   "prompt_message_count": 1,
90   "completion_message_count": 1,
91   "trace_unique_id": "string",
92   "span_unique_id": "string",
93   "span_name": "string",
94   "span_parent_id": "string",
95   "span_workflow_name": "string",
96   "session_identifier": "string",
97   "span_links": "string",
98   "trace_group_identifier": "string",
99   "thread_identifier": "string",
100   "thread_unique_id": "string",
101   "storage_object_key": "string",
102   "period_start": "2024-01-15T09:30:00Z",
103   "period_end": "2024-01-15T09:30:00Z",
104   "unique_id": "string",
105   "respan_gateway_request_id": "string",
106   "full_text": "string"
107 }

Update mutable fields via lightweight UPDATE (CH 25.7+).

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

unique_idstringRequired

Request

This endpoint expects an object.

idstringOptional>=1 character

organization_idstringOptional>=1 character

unique_organization_idstringOptional>=1 character

organization_namestringOptional>=1 character

error_messagestringOptional>=1 character

completion_messagesanyOptional

inputstringOptional>=1 character

outputstringOptional>=1 character

variablesanyOptional

temperaturedoubleOptional

max_tokensintegerOptional

top_pdoubleOptional

frequency_penaltydoubleOptional

presence_penaltydoubleOptional

stopstringOptional>=1 character

response_formatanyOptional

matched_meter_idslist of anyOptional

unit_pricesmap from strings to anyOptional

component_costsmap from strings to anyOptional

custom_identifierstringOptional<=255 characters

group_identifierstringOptional<=120 characters

blurredbooleanOptional

start_timedatetimeOptional

timestampdatetimeOptional

load_balance_group_idstringOptional<=100 characters

prompt_tokensintegerOptional-2147483648-2147483647

completion_tokensintegerOptional-2147483648-2147483647

prompt_cache_hit_tokensintegerOptional-2147483648-2147483647

prompt_cache_creation_tokensintegerOptional-2147483648-2147483647

reasoning_tokensintegerOptional-2147483648-2147483647

total_request_tokensintegerOptional-2147483648-2147483647

is_token_count_estimatedintegerOptional0-255

costdoubleOptional

llm_gateway_markup_ratedoubleOptional

service_tierstringOptional<=50 characters

model_discountdoubleOptional

pricing_tierstringOptional

audio_input_filestringOptional

audio_output_filestringOptional

organization_key_idstringOptional

user_emailstringOptional

modelstringOptional<=100 characters

provider_idstringOptional<=100 characters

categorystringOptional<=60 characters

propertiesstringOptional

cache_bitintegerOptional0-255

cache_miss_bitintegerOptional0-255

cache_keystringOptional<=254 characters

latencydoubleOptional

tokens_per_seconddoubleOptional

time_to_first_tokendoubleOptional

routing_timedoubleOptional

statusstringOptional<=100 characters

has_tool_callsbooleanOptional

status_codeintegerOptional-32768-32767

log_methodstringOptional1-20 characters

log_typestringOptional1-20 characters

environmentstringOptional<=100 characters

streambooleanOptional

evaluation_identifierstringOptional<=100 characters

customer_identifierstringOptional<=254 characters

customer_emailstringOptional<=254 characters

customer_namestringOptional<=254 characters

customer_user_unique_idstringOptional<=255 characters

used_custom_credentialbooleanOptional

deployment_namestringOptional<=254 characters

deployment_idstringOptional<=100 characters

prompt_namestringOptional<=255 characters

prompt_idstringOptional<=100 characters

prompt_version_numberintegerOptional0-65535

system_textstringOptional

prompt_textstringOptional

completion_textstringOptional

prompt_message_countintegerOptional-2147483648-2147483647

completion_message_countintegerOptional-2147483648-2147483647

trace_unique_idstringOptional<=255 characters

span_unique_idstringOptional<=255 characters

span_namestringOptional<=255 characters

span_parent_idstringOptional<=100 characters

span_workflow_namestringOptional<=255 characters

session_identifierstringOptional<=255 characters

span_linksstringOptional

trace_group_identifierstringOptional<=255 characters

thread_identifierstringOptional<=255 characters

thread_unique_idstringOptional

storage_object_keystringOptional

period_startdatetimeOptional

period_enddatetimeOptional

unique_idstringOptional1-60 characters

respan_gateway_request_idstringOptional<=60 characters

full_textstringOptional<=10000 characters

Response

idstring

input_wordsstringRead-only

output_wordsstringRead-only

input_charsstringRead-only

output_charsstringRead-only

organization_key_namestringRead-only

organization_idstring

warningsstringRead-only

annotation_statusstringRead-only

keywordsai_paramsstringRead-only

full_requeststringRead-only

full_responsestringRead-only

metadatastringRead-only

toolsstringRead-only

tool_callsstringRead-only

prompt_messagesstringRead-only

completion_messagestringRead-only

unique_organization_idstring

organization_namestring

error_messagestring

completion_messagesany

inputstring

outputstring

variablesany

temperaturedouble

max_tokensinteger

top_pdouble

frequency_penaltydouble

presence_penaltydouble

stopstring

response_formatany

matched_meter_idslist of any

unit_pricesmap from strings to any

component_costsmap from strings to any

custom_identifierstring<=255 characters

group_identifierstring<=120 characters

blurredboolean

start_timedatetime

timestampdatetime

load_balance_group_idstring<=100 characters

prompt_tokensinteger-2147483648-2147483647

completion_tokensinteger-2147483648-2147483647

prompt_cache_hit_tokensinteger-2147483648-2147483647

prompt_cache_creation_tokensinteger-2147483648-2147483647

reasoning_tokensinteger-2147483648-2147483647

total_request_tokensinteger-2147483648-2147483647

is_token_count_estimatedinteger0-255

costdouble

llm_gateway_markup_ratedouble

service_tierstring<=50 characters

model_discountdouble

pricing_tierstring

audio_input_filestring

audio_output_filestring

organization_key_idstring

user_emailstring

modelstring<=100 characters

provider_idstring<=100 characters

categorystring<=60 characters

propertiesstring

cache_bitinteger0-255

cache_miss_bitinteger0-255

cache_keystring<=254 characters

latencydouble

tokens_per_seconddouble

time_to_first_tokendouble

routing_timedouble

statusstring<=100 characters

has_tool_callsboolean

status_codeinteger-32768-32767

log_methodstring<=20 characters

log_typestring<=20 characters

environmentstring<=100 characters

streamboolean

evaluation_identifierstring<=100 characters

customer_identifierstring<=254 characters

customer_emailstring<=254 characters

customer_namestring<=254 characters

customer_user_unique_idstring<=255 characters

used_custom_credentialboolean

deployment_namestring<=254 characters

deployment_idstring<=100 characters

prompt_namestring<=255 characters

prompt_idstring<=100 characters

prompt_version_numberinteger0-65535

system_textstring

prompt_textstring

completion_textstring

prompt_message_countinteger-2147483648-2147483647

completion_message_countinteger-2147483648-2147483647

trace_unique_idstring<=255 characters

span_unique_idstring<=255 characters

span_namestring<=255 characters

span_parent_idstring<=100 characters

span_workflow_namestring<=255 characters

session_identifierstring<=255 characters

span_linksstring

trace_group_identifierstring<=255 characters

thread_identifierstring<=255 characters

thread_unique_idstring

storage_object_keystring

period_startdatetime

period_enddatetime

unique_idstring<=60 characters

respan_gateway_request_idstring<=60 characters

full_textstring<=10000 characters