Api Request Logs Create Create

Centralized respan_params initialization and backward-compat layer. This mixin is the SINGLE initialization point for ``respan_params``. It runs ``_initialize_respan_params()`` BEFORE ``super().initial()`` so that by the time the throttle runs, ``respan_params`` is a fully resolved dict. Downstream code (throttle, preprocessing, view handler) only **enriches** the existing dict — they never need to create it. Initialization order:: _initialize_respan_params() ← legacy rename + header parse + metadata ↓ super().initial() ← throttle ENRICHES the existing dict ↓ view handler ← billing, security strip, etc. Responsibilities consolidated here (previously scattered across 4 callsites): 1. Legacy header rename (X-Data-Keywordsai-Params → X-Data-Respan-Params) 2. Parse X-Data-Respan-Params header (base64 → dict) 3. Legacy body rename (keywordsai_params → respan_params) 4. Form data handling (JSON string → dict) 5. Metadata nesting (passthrough endpoints — Anthropic, Google, etc.) 6. Merge: {**header_params, **body_params} (body wins on field conflict) 7. Add request_url_path from request.META['PATH_INFO'] 8. Guarantee request.data[RESPAN_PARAMS_KEY] is always a dict Safe for protobuf endpoints: body adaptation is skipped when request.data is not a dict; header adaptation always runs. Usage:: class MyChatView(AdaptRespanParamsMixin, APIView): ...

Authentication

AuthorizationBearer
JWT access token or Respan API key

Request

This endpoint expects an object.
ip_addressstring or nullOptional<=100 characters
pre_commit_idstring or nullOptional<=120 characters
custom_identifierstring or nullOptional<=120 characters
group_identifierstring or nullOptional<=120 characters
blurredboolean or nullOptional
hour_groupdatetimeOptional
minute_groupdatetimeOptional
start_timedatetime or nullOptional
timestampdatetimeOptional
load_balance_group_idstringOptional<=100 characters
unique_idstring or nullOptional1-100 characters
mapped_model_namestringOptional<=255 characters
response_formatanyOptional
response_format_choicestring or nullOptional<=100 characters
parallel_tool_callsboolean or nullOptional
prompt_tokensintegerOptional-2147483648-2147483647
completion_tokensintegerOptional-2147483648-2147483647
prompt_cache_hit_tokensinteger or nullOptional-2147483648-2147483647
prompt_cache_creation_tokensinteger or nullOptional-2147483648-2147483647
total_request_tokensintegerOptional-2147483648-2147483647
costdoubleOptional
inputstringOptional
input_arraylist of strings or nullOptional
encoding_formatstringOptional<=100 characters
dimensionsinteger or nullOptional-2147483648-2147483647
embeddinglist of doubles or nullOptional
base64_embeddingstring or nullOptional
audio_input_filestring or nullOptionalformat: "binary"
transcriptionstringOptional
audio_response_formatstringOptional<=100 characters
audio_output_filestring or nullOptionalformat: "binary"
prompt_messageslist of anyOptional
completion_messageanyOptional
completion_messageslist of any or nullOptional
latencydouble or nullOptional
modelstringOptional<=100 characters
calling_modelstring or nullOptional<=100 characters
foundation_modelstringOptional<=100 characters
provider_idstringOptional<=100 characters
full_model_namestring or nullOptional<=200 characters
tool_choiceanyOptional
toolsanyOptional
tool_callsanyOptional
has_tool_callsbooleanOptional
categorystringOptional<=60 characters
time_to_first_tokendouble or nullOptional
routing_timedoubleOptional
keywordsai_paramsanyOptional
notestringOptional
session_idstringOptional<=254 characters
metadataanyOptional
metadata_indexed_string_1string or nullOptional
metadata_indexed_string_2string or nullOptional
metadata_indexed_numerical_1double or nullOptional
cachedbooleanOptional
cache_bitintegerOptional-2147483648-2147483647
cache_miss_bitinteger or nullOptional-32768-32767
cache_keystring or nullOptional<=254 characters
positive_feedbackboolean or nullOptional
tokens_per_seconddoubleOptional
full_requestanyOptional
full_responseanyOptional
statusenumOptional
status_codeintegerOptional-2147483648-2147483647
warningsstringOptional
recommendationsstring or nullOptional
has_warningsbooleanOptional
error_messagestringOptional
is_examplebooleanOptional
is_maliciousbooleanOptional
log_methodenumOptional
  • inference - Inference
  • logging_api - Logging Api
  • batch - Batch
  • python_tracing - Python Tracing
  • ts_tracing - Ts Tracing
  • tracing_integration - Tracing Integration
log_typeenumOptional
  • text - Text
  • chat - Chat
  • completion - Completion
  • response - Response
  • embedding - Embedding
  • transcription - Transcription
  • speech - Speech
  • workflow - Workflow
  • task - Task
  • tool - Tool
  • agent - Agent
  • handoff - Handoff
  • guardrail - Guardrail
  • function - Function
  • custom - Custom
  • generation - Generation
  • unknown - Unknown
  • score - Score
  • batch - Batch
  • span - Span
failedbooleanOptional
error_bitintegerOptional-2147483648-2147483647
is_testbooleanOptional
environmentenumOptional
streambooleanOptional
stream_optionsanyOptional
temperaturedouble or nullOptional
max_tokensinteger or nullOptional-2147483648-2147483647
logit_biasanyOptional
logprobsboolean or nullOptional
top_logprobsinteger or nullOptional-2147483648-2147483647
frequency_penaltydouble or nullOptional
presence_penaltydouble or nullOptional
stopstring or nullOptional
ninteger or nullOptional-2147483648-2147483647
evaluation_identifierstring or nullOptional<=120 characters
is_datasetbooleanOptional
based_log_unique_idstring or nullOptional<=100 characters
customer_identifierstringOptional<=254 characters
customer_emailstringOptionalformat: "email"<=254 characters
customer_namestringOptional<=254 characters
customer_user_unique_idstring or nullOptional<=255 characters
used_custom_credentialbooleanOptional
deployment_namestringOptional<=254 characters
custom_endpointstring or nullOptional<=254 characters
custom_regionstring or nullOptional<=254 characters
prompt_namestring or nullOptional<=255 characters
prompt_idstringOptional<=100 characters
prompt_version_numberinteger or nullOptional-2147483648-2147483647
covered_byenumOptional
  • own_credential - Own Credential
  • user - User
  • credits - Credits
  • credit_and_credential - Credit And Credential
  • cache_hit - Cache Hit
  • credit_and_cache - Credit And Cache
system_textstring or nullOptional
prompt_textstring or nullOptional
completion_textstring or nullOptional
system_text_vectorstring or nullOptional
prompt_text_vectorstring or nullOptional
completion_text_vectorstring or nullOptional
full_text_indexedbooleanOptional
trace_unique_idstring or nullOptional<=255 characters
span_unique_idstring or nullOptional<=255 characters
trace_group_identifierstring or nullOptional<=255 characters
span_namestring or nullOptional<=100 characters
span_handoffslist of strings or nullOptional
span_toolslist of strings or nullOptional
span_parent_idstring or nullOptional<=100 characters
span_pathstring or nullOptional
span_workflow_namestring or nullOptional<=255 characters
outputstring or nullOptional
thread_identifierstringOptional<=120 characters
thread_unique_idstring or nullOptional<=255 characters
storage_object_keystring or nullOptional
evaluation_costdoubleOptional
LLM_based_context_precisiondouble or nullOptional
LLM_based_faithfulnessdouble or nullOptional
flesch_reading_easedouble or nullOptional
flesch_kincaid_grade_leveldouble or nullOptional
LLM_based_answer_relevancedouble or nullOptional
amount_to_paydouble or nullOptional
full_cost_calculatedboolean or nullOptional
stripe_usage_report_sentboolean or nullOptional
to_update_threadboolean or nullOptional
to_update_customer_userboolean or nullOptional
organizationinteger or nullOptional
company_organizationinteger or nullOptional
userinteger or nullOptional
organization_keystring or nullOptional>=1 character
customer_userinteger or nullOptional
prompt_versioninteger or nullOptional
threadinteger or nullOptional
traceinteger or nullOptional
spaninteger or nullOptional

Response

idintegerRead-only
ip_addressstring or nullOptional<=100 characters
pre_commit_idstring or nullOptional<=120 characters
custom_identifierstring or nullOptional<=120 characters
group_identifierstring or nullOptional<=120 characters
blurredboolean or nullOptional
hour_groupdatetimeOptional
minute_groupdatetimeOptional
start_timedatetime or nullOptional
timestampdatetimeOptional
load_balance_group_idstringOptional<=100 characters
unique_idstring or nullOptional<=100 characters
mapped_model_namestringOptional<=255 characters
response_formatanyOptional
response_format_choicestring or nullOptional<=100 characters
parallel_tool_callsboolean or nullOptional
prompt_tokensintegerOptional-2147483648-2147483647
completion_tokensintegerOptional-2147483648-2147483647
prompt_cache_hit_tokensinteger or nullOptional-2147483648-2147483647
prompt_cache_creation_tokensinteger or nullOptional-2147483648-2147483647
total_request_tokensintegerOptional-2147483648-2147483647
costdoubleOptional
inputstringOptional
input_arraylist of strings or nullOptional
encoding_formatstringOptional<=100 characters
dimensionsinteger or nullOptional-2147483648-2147483647
embeddinglist of doubles or nullOptional
base64_embeddingstring or nullOptional
audio_input_filestring or nullOptionalformat: "uri"
transcriptionstringOptional
audio_response_formatstringOptional<=100 characters
audio_output_filestring or nullOptionalformat: "uri"
prompt_messageslist of anyOptional
completion_messageanyOptional
completion_messageslist of any or nullOptional
latencydouble or nullOptional
modelstringOptional<=100 characters
calling_modelstring or nullOptional<=100 characters
foundation_modelstringOptional<=100 characters
provider_idstringOptional<=100 characters
full_model_namestring or nullOptional<=200 characters
tool_choiceanyOptional
toolsanyOptional
tool_callsanyOptional
has_tool_callsbooleanOptional
categorystringOptional<=60 characters
time_to_first_tokendouble or nullOptional
routing_timedoubleOptional
keywordsai_paramsanyOptional
notestringOptional
session_idstringOptional<=254 characters
metadataanyOptional
metadata_indexed_string_1string or nullOptional
metadata_indexed_string_2string or nullOptional
metadata_indexed_numerical_1double or nullOptional
cachedbooleanOptional
cache_bitintegerOptional-2147483648-2147483647
cache_miss_bitinteger or nullOptional-32768-32767
cache_keystring or nullOptional<=254 characters
positive_feedbackboolean or nullOptional
tokens_per_seconddoubleOptional
full_requestanyOptional
full_responseanyOptional
statusenumOptional
status_codeintegerOptional-2147483648-2147483647
warningsstringOptional
recommendationsstring or nullOptional
has_warningsbooleanOptional
error_messagestringOptional
is_examplebooleanOptional
is_maliciousbooleanOptional
log_methodenumOptional
  • inference - Inference
  • logging_api - Logging Api
  • batch - Batch
  • python_tracing - Python Tracing
  • ts_tracing - Ts Tracing
  • tracing_integration - Tracing Integration
log_typeenumOptional
  • text - Text
  • chat - Chat
  • completion - Completion
  • response - Response
  • embedding - Embedding
  • transcription - Transcription
  • speech - Speech
  • workflow - Workflow
  • task - Task
  • tool - Tool
  • agent - Agent
  • handoff - Handoff
  • guardrail - Guardrail
  • function - Function
  • custom - Custom
  • generation - Generation
  • unknown - Unknown
  • score - Score
  • batch - Batch
  • span - Span
failedbooleanOptional
error_bitintegerOptional-2147483648-2147483647
is_testbooleanOptional
environmentenumOptional
streambooleanOptional
stream_optionsanyOptional
temperaturedouble or nullOptional
max_tokensinteger or nullOptional-2147483648-2147483647
logit_biasanyOptional
logprobsboolean or nullOptional
top_logprobsinteger or nullOptional-2147483648-2147483647
frequency_penaltydouble or nullOptional
presence_penaltydouble or nullOptional
stopstring or nullOptional
ninteger or nullOptional-2147483648-2147483647
evaluation_identifierstring or nullOptional<=120 characters
is_datasetbooleanOptional
based_log_unique_idstring or nullOptional<=100 characters
customer_identifierstringOptional<=254 characters
customer_emailstringOptionalformat: "email"<=254 characters
customer_namestringOptional<=254 characters
customer_user_unique_idstring or nullOptional<=255 characters
used_custom_credentialbooleanOptional
deployment_namestringOptional<=254 characters
custom_endpointstring or nullOptional<=254 characters
custom_regionstring or nullOptional<=254 characters
prompt_namestring or nullOptional<=255 characters
prompt_idstringOptional<=100 characters
prompt_version_numberinteger or nullOptional-2147483648-2147483647
covered_byenumOptional
  • own_credential - Own Credential
  • user - User
  • credits - Credits
  • credit_and_credential - Credit And Credential
  • cache_hit - Cache Hit
  • credit_and_cache - Credit And Cache
system_textstring or nullOptional
prompt_textstring or nullOptional
completion_textstring or nullOptional
system_text_vectorstring or nullOptional
prompt_text_vectorstring or nullOptional
completion_text_vectorstring or nullOptional
full_text_indexedbooleanOptional
trace_unique_idstring or nullOptional<=255 characters
span_unique_idstring or nullOptional<=255 characters
trace_group_identifierstring or nullOptional<=255 characters
span_namestring or nullOptional<=100 characters
span_handoffslist of strings or nullOptional
span_toolslist of strings or nullOptional
span_parent_idstring or nullOptional<=100 characters
span_pathstring or nullOptional
span_workflow_namestring or nullOptional<=255 characters
outputstring or nullOptional
thread_identifierstringOptional<=120 characters
thread_unique_idstring or nullOptional<=255 characters
storage_object_keystring or nullOptional
evaluation_costdoubleOptional
LLM_based_context_precisiondouble or nullOptional
LLM_based_faithfulnessdouble or nullOptional
flesch_reading_easedouble or nullOptional
flesch_kincaid_grade_leveldouble or nullOptional
LLM_based_answer_relevancedouble or nullOptional
amount_to_paydouble or nullOptional
full_cost_calculatedboolean or nullOptional
stripe_usage_report_sentboolean or nullOptional
to_update_threadboolean or nullOptional
to_update_customer_userboolean or nullOptional
organizationinteger or nullOptional
company_organizationinteger or nullOptional
userinteger or nullOptional
organization_keystring or nullOptional
customer_userinteger or nullOptional
prompt_versioninteger or nullOptional
threadinteger or nullOptional
traceinteger or nullOptional
spaninteger or nullOptional