Clickhouse Request Logs Partial Update

PATCH

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

PATCH

/clickhouse/request-logs/

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

200Updated

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

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer

JWT access token or Respan API key

Request

This endpoint expects an object.

idstringOptional>=1 character

organization_idstringOptional>=1 character

unique_organization_idstringOptional>=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

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

organization_key_namestringRead-only

warningsstringRead-only

status_in_eval_setstringRead-only

full_requeststringRead-only

full_responsestringRead-only

metadatastringRead-only

scoresstringRead-only

toolsstringRead-only

tool_callsstringRead-only

prompt_messagesstringRead-only

completion_messagestringRead-only

organization_idstringOptional

unique_organization_idstringOptional

error_messagestringOptional