@@ -164,6 +164,7 @@ def create(
164164 agent_id : str | Omit = omit ,
165165 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
166166 metadata : Optional [Dict [str , str ]] | Omit = omit ,
167+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
167168 review : Literal ["none" , "auto_review" ] | Omit = omit ,
168169 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
169170 stream : Literal [False ] | Omit = omit ,
@@ -187,6 +188,7 @@ def create(
187188 agent_id : str | Omit = omit ,
188189 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
189190 metadata : Optional [Dict [str , str ]] | Omit = omit ,
191+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
190192 review : Literal ["none" , "auto_review" ] | Omit = omit ,
191193 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
192194 stream_options : session_create_params .StreamOptions | Omit = omit ,
@@ -209,6 +211,7 @@ def create(
209211 agent_id : str | Omit = omit ,
210212 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
211213 metadata : Optional [Dict [str , str ]] | Omit = omit ,
214+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
212215 review : Literal ["none" , "auto_review" ] | Omit = omit ,
213216 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
214217 stream_options : session_create_params .StreamOptions | Omit = omit ,
@@ -230,6 +233,7 @@ def create(
230233 agent_id : str | Omit = omit ,
231234 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
232235 metadata : Optional [Dict [str , str ]] | Omit = omit ,
236+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
233237 review : Literal ["none" , "auto_review" ] | Omit = omit ,
234238 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
235239 stream : Literal [False ] | Literal [True ] | Omit = omit ,
@@ -250,6 +254,7 @@ def create(
250254 "agent_id" : agent_id ,
251255 "input" : input ,
252256 "metadata" : metadata ,
257+ "prompt_cache_options" : prompt_cache_options ,
253258 "review" : review ,
254259 "spend_control" : spend_control ,
255260 "stream_options" : stream_options ,
@@ -328,6 +333,7 @@ def update(
328333 * ,
329334 agent : session_update_params .Agent | Omit = omit ,
330335 metadata : Optional [Dict [str , str ]] | Omit = omit ,
336+ prompt_cache_options : Optional [session_update_params .PromptCacheOptions ] | Omit = omit ,
331337 review : Literal ["none" , "auto_review" ] | Omit = omit ,
332338 spend_control : Optional [session_update_params .SpendControl ] | Omit = omit ,
333339 # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -337,10 +343,10 @@ def update(
337343 extra_body : Body | None = None ,
338344 timeout : float | httpx2 .Timeout | None | NotGiven = not_given ,
339345 ) -> AgentSession :
340- """Updates session tools, metadata, model, reasoning effort, or service tier.
341-
342- Model
343- settings apply to subsequent turns. Omitted fields are unchanged. See
346+ """
347+ Updates session tools, metadata, model, reasoning effort, service tier, or the
348+ default prompt cache lifetime. Model settings apply to subsequent turns. Omitted
349+ fields are unchanged. See
344350 [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
345351
346352 Args:
@@ -350,6 +356,9 @@ def update(
350356 Up to 16 string key-value pairs, with keys up to 64 and values up to 512
351357 characters.
352358
359+ prompt_cache_options: Default prompt cache lifetime for future turns. Send null to clear the session
360+ default.
361+
353362 review: Default action review for new root turns. Existing turns and their subagents
354363 keep their review mode.
355364
@@ -377,6 +386,7 @@ def update(
377386 {
378387 "agent" : agent ,
379388 "metadata" : metadata ,
389+ "prompt_cache_options" : prompt_cache_options ,
380390 "review" : review ,
381391 "spend_control" : spend_control ,
382392 },
@@ -592,6 +602,7 @@ async def create(
592602 agent_id : str | Omit = omit ,
593603 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
594604 metadata : Optional [Dict [str , str ]] | Omit = omit ,
605+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
595606 review : Literal ["none" , "auto_review" ] | Omit = omit ,
596607 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
597608 stream : Literal [False ] | Omit = omit ,
@@ -615,6 +626,7 @@ async def create(
615626 agent_id : str | Omit = omit ,
616627 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
617628 metadata : Optional [Dict [str , str ]] | Omit = omit ,
629+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
618630 review : Literal ["none" , "auto_review" ] | Omit = omit ,
619631 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
620632 stream_options : session_create_params .StreamOptions | Omit = omit ,
@@ -637,6 +649,7 @@ async def create(
637649 agent_id : str | Omit = omit ,
638650 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
639651 metadata : Optional [Dict [str , str ]] | Omit = omit ,
652+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
640653 review : Literal ["none" , "auto_review" ] | Omit = omit ,
641654 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
642655 stream_options : session_create_params .StreamOptions | Omit = omit ,
@@ -658,6 +671,7 @@ async def create(
658671 agent_id : str | Omit = omit ,
659672 input : Union [str , Iterable [AgentSessionInputMessageParam ], None ] | Omit = omit ,
660673 metadata : Optional [Dict [str , str ]] | Omit = omit ,
674+ prompt_cache_options : Optional [session_create_params .PromptCacheOptions ] | Omit = omit ,
661675 review : Literal ["none" , "auto_review" ] | Omit = omit ,
662676 spend_control : Optional [session_create_params .SpendControl ] | Omit = omit ,
663677 stream : Literal [False ] | Literal [True ] | Omit = omit ,
@@ -678,6 +692,7 @@ async def create(
678692 "agent_id" : agent_id ,
679693 "input" : input ,
680694 "metadata" : metadata ,
695+ "prompt_cache_options" : prompt_cache_options ,
681696 "review" : review ,
682697 "spend_control" : spend_control ,
683698 "stream_options" : stream_options ,
@@ -756,6 +771,7 @@ async def update(
756771 * ,
757772 agent : session_update_params .Agent | Omit = omit ,
758773 metadata : Optional [Dict [str , str ]] | Omit = omit ,
774+ prompt_cache_options : Optional [session_update_params .PromptCacheOptions ] | Omit = omit ,
759775 review : Literal ["none" , "auto_review" ] | Omit = omit ,
760776 spend_control : Optional [session_update_params .SpendControl ] | Omit = omit ,
761777 # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -765,10 +781,10 @@ async def update(
765781 extra_body : Body | None = None ,
766782 timeout : float | httpx2 .Timeout | None | NotGiven = not_given ,
767783 ) -> AgentSession :
768- """Updates session tools, metadata, model, reasoning effort, or service tier.
769-
770- Model
771- settings apply to subsequent turns. Omitted fields are unchanged. See
784+ """
785+ Updates session tools, metadata, model, reasoning effort, service tier, or the
786+ default prompt cache lifetime. Model settings apply to subsequent turns. Omitted
787+ fields are unchanged. See
772788 [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
773789
774790 Args:
@@ -778,6 +794,9 @@ async def update(
778794 Up to 16 string key-value pairs, with keys up to 64 and values up to 512
779795 characters.
780796
797+ prompt_cache_options: Default prompt cache lifetime for future turns. Send null to clear the session
798+ default.
799+
781800 review: Default action review for new root turns. Existing turns and their subagents
782801 keep their review mode.
783802
@@ -805,6 +824,7 @@ async def update(
805824 {
806825 "agent" : agent ,
807826 "metadata" : metadata ,
827+ "prompt_cache_options" : prompt_cache_options ,
808828 "review" : review ,
809829 "spend_control" : spend_control ,
810830 },
0 commit comments