v3

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

Get Spans Summary

POST handler with superadmin-only field protection.

Strips superadmin-only fields from non-superadmin requests before delegating to OrganizationInjectionMixin.post() for org injection.

post/api/request-logs/summary/

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 required
organization_idstring required
organization_key_idstring required
environmentstring required
timestampstring date-time
start_timestring date-time
prompt_idstring
prompt_namestring required
trace_unique_idstring required
customer_identifierstring required
customer_namestring
customer_emailstring
thread_identifierstring required
custom_identifierstring
unique_organization_idstring required
log_typestring required
prompt_tokensinteger
completion_tokensinteger
total_request_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
costnumber double
modelstring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
status_codeinteger
statusstring
blurredboolean
storage_object_keystring
updated_storage_object_keystring
span_workflow_namestring
span_namestring
notestring

Response

idstring required
organization_idstring required
organization_key_idstring required
environmentstring required
timestampstring date-time
start_timestring date-time
prompt_idstring
prompt_namestring required
trace_unique_idstring required
customer_identifierstring required
customer_namestring
customer_emailstring
thread_identifierstring required
custom_identifierstring
unique_organization_idstring required
log_typestring required
prompt_tokensinteger
completion_tokensinteger
total_request_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
costnumber double
modelstring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
status_codeinteger
statusstring
blurredboolean
metadatastring required
scoresstring required
storage_object_keystring
updated_storage_object_keystring
systemstring required
promptstring required
completionstring required
span_workflow_namestring
span_namestring
positive_feedbackstring required
notestring