From 21549a3463967c4ea871f5567c92a5ed2a48e46c Mon Sep 17 00:00:00 2001 From: Krrish Dholakia Date: Sat, 16 Aug 2025 17:55:18 -0700 Subject: [PATCH] docs(index.md): write up on session management --- docs/my-website/docs/response_api.md | 11 +++++++++-- .../responses_api_session_mgt_images.jpg | Bin 0 -> 482862 bytes .../release_notes/v1.75.5-stable/index.md | 15 ++++++++++++--- 3 files changed, 21 insertions(+), 5 deletions(-) create mode 100644 docs/my-website/img/release_notes/responses_api_session_mgt_images.jpg diff --git a/docs/my-website/docs/response_api.md b/docs/my-website/docs/response_api.md index e64f922ac80..c0bb003c096 100644 --- a/docs/my-website/docs/response_api.md +++ b/docs/my-website/docs/response_api.md @@ -803,11 +803,18 @@ LiteLLM Proxy supports session management for non-OpenAI models. This allows you 1. Enable storing request / response content in the database -Set `store_prompts_in_spend_logs: true` in your proxy config.yaml. When this is enabled, LiteLLM will store the request and response content in the database. +Set `store_prompts_in_cold_storage: true` in your proxy config.yaml. When this is enabled, LiteLLM will store the request and response content in the s3 bucket you specify. ```yaml +litellm_settings: + callbacks: ["s3_v2"] + s3_callback_params: # learn more https://docs.litellm.ai/docs/proxy/logging#s3-buckets + s3_bucket_name: litellm-logs # AWS Bucket Name for S3 + s3_region_name: us-west-2 + general_settings: - store_prompts_in_spend_logs: true + cold_storage_custom_logger: s3_v2 + store_prompts_in_cold_storage: true ``` 2. Make request 1 with no `previous_response_id` (new session) diff --git a/docs/my-website/img/release_notes/responses_api_session_mgt_images.jpg b/docs/my-website/img/release_notes/responses_api_session_mgt_images.jpg new file mode 100644 index 0000000000000000000000000000000000000000..852d2fdd6d01ce47ee03fcbad12860c8ad171b2c GIT binary patch literal 482862 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