4e064cf81dae
latestOpenAPI 3.1.02026-08-131831,331960.0 KBspans
Filter span groups
Group spans using the same query parameters as GET and optional standard Respan filters in the request body.
post/api/request-logs/groups/
Query parameters
group_by'model' | 'provider_id' | 'organization_key_id' | 'prompt_id' | 'deployment_id' | 'deployment_name' | 'custom_identifier' | 'customer_identifier' | 'trace' | 'thread'
Grouping dimension. trace and thread use entity rollups.
sort_bystring
start_timestring date-time
end_timestring date-time
environmentstring
pageinteger
page_sizeinteger
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
Response
Paginated groups and aggregate metrics.