@@ -561,14 +561,17 @@ def __init__(self, connection: RealtimeConnection) -> None:
561
561
562
562
class RealtimeSessionResource (BaseRealtimeConnectionResource ):
563
563
def update (self , * , session : session_update_event_param .Session , event_id : str | NotGiven = NOT_GIVEN ) -> None :
564
- """Send this event to update the session’s default configuration.
564
+ """
565
+ Send this event to update the session’s default configuration.
566
+ The client may send this event at any time to update any field,
567
+ except for `voice`. However, note that once a session has been
568
+ initialized with a particular `model`, it can’t be changed to
569
+ another model using `session.update`.
565
570
566
- The client may
567
- send this event at any time to update the session configuration, and any
568
- field may be updated at any time, except for "voice". The server will respond
569
- with a `session.updated` event that shows the full effective configuration.
570
- Only fields that are present are updated, thus the correct way to clear a
571
- field like "instructions" is to pass an empty string.
571
+ When the server receives a `session.update`, it will respond
572
+ with a `session.updated` event showing the full, effective configuration.
573
+ Only the fields that are present are updated. To clear a field like
574
+ `instructions`, pass an empty string.
572
575
"""
573
576
self ._connection .send (
574
577
cast (
@@ -768,14 +771,17 @@ class AsyncRealtimeSessionResource(BaseAsyncRealtimeConnectionResource):
768
771
async def update (
769
772
self , * , session : session_update_event_param .Session , event_id : str | NotGiven = NOT_GIVEN
770
773
) -> None :
771
- """Send this event to update the session’s default configuration.
772
-
773
- The client may
774
- send this event at any time to update the session configuration, and any
775
- field may be updated at any time, except for "voice". The server will respond
776
- with a `session.updated` event that shows the full effective configuration.
777
- Only fields that are present are updated, thus the correct way to clear a
778
- field like "instructions" is to pass an empty string.
774
+ """
775
+ Send this event to update the session’s default configuration.
776
+ The client may send this event at any time to update any field,
777
+ except for `voice`. However, note that once a session has been
778
+ initialized with a particular `model`, it can’t be changed to
779
+ another model using `session.update`.
780
+
781
+ When the server receives a `session.update`, it will respond
782
+ with a `session.updated` event showing the full, effective configuration.
783
+ Only the fields that are present are updated. To clear a field like
784
+ `instructions`, pass an empty string.
779
785
"""
780
786
await self ._connection .send (
781
787
cast (
0 commit comments