telnyx 5.174.0 → 5.175.0

data/lib/telnyx/models/meeting_session_create_params.rb

@@ -14,10 +14,8 @@ module Telnyx
       required :meeting_url, String
 
       # @!attribute assistant
-      #   Attach a Telnyx AI Assistant to the session. Supply the Assistant's ID; the
-      #   Meeting service connects it to the meeting directly. The Call Control
-      #   connection, caller ID and loopback SIP URI previously required here have been
-      #   removed and are now rejected as unknown fields.
+      #   Attach a Telnyx AI Assistant owned by the authenticated account. Supply its ID
+      #   and optional conversation settings. Unknown fields are rejected.
       #
       #   @return [Telnyx::Models::MeetingSessionCreateParams::Assistant, nil]
       optional :assistant, -> { Telnyx::MeetingSessionCreateParams::Assistant }
@@ -37,12 +35,13 @@ module Telnyx
       optional :bot_name, String
 
       # @!attribute camera_image
-      #   Write-only static camera-tile image for this session, not a native account or
+      #   Not supported for Google Meet and Teams joins (422 unsupported_capability).
+      #   Write-only static camera-tile image for this session, not an account or
       #   participant profile photo. Supply exactly one JPEG source. When effective, the
       #   image is used as the bot's static camera/video output; presentation varies by
       #   meeting platform and recording configuration and is not guaranteed in
-      #   recordings. An effective Avatar or Assistant webpage output takes precedence, so
-      #   this input is ignored and a URL source is not fetched.
+      #   recordings. An attached assistant or avatar takes precedence, so this input is
+      #   ignored and a URL source is not fetched.
       #
       #   @return [Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource, nil]
       optional :camera_image, union: -> { Telnyx::MeetingSessionCreateParams::CameraImage }
@@ -52,26 +51,38 @@ module Telnyx
       #   typically a recording disclosure. Delivered at most once. Independent of
       #   `speak_on_enter`: both may be set, and the chat message posts first because it
       #   does not wait for text-to-speech or avatar startup. Rejected with 422
-      #   `unsupported_capability` on platforms without meeting chat.
+      #   `unsupported_capability` on platforms without meeting chat. For Google Meet and
+      #   Teams, text must be nonblank, at most 4096 UTF-8 bytes, with no control
+      #   characters except tabs and line breaks. Counts toward the 1000-chat-request
+      #   session limit.
       #
       #   @return [String, nil]
       optional :chat_on_enter, String
 
       # @!attribute idempotency_key
-      #   Client-supplied idempotency key to safely retry creation requests without
-      #   duplicating sessions. Lookup is scoped to the authenticated account and compares
-      #   the key only; the request payload is not fingerprinted or compared.
+      #   Use a unique key per intended join and reuse the same key and request on
+      #   retries. Reusing a key with a different join configuration or meeting URL can
+      #   return 409 invalid_state. Always retry with the original request.
       #
       #   @return [String, nil]
       optional :idempotency_key, String
 
       # @!attribute join_at
-      #   ISO-8601 timestamp in the future at which the bot should join. If omitted, the
-      #   bot joins immediately.
+      #   Future ISO-8601 join timestamp including timezone. Google Meet and Teams accept
+      #   dates at most three years ahead. Omit for an immediate join. Assistant sessions
+      #   created through this endpoint must join immediately.
       #
       #   @return [Time, nil]
       optional :join_at, Time
 
+      # @!attribute leave_policy
+      #   Automatic departure settings for Google Meet and Teams. Omitted fields use the
+      #   default behavior. Set at creation; cannot be changed later. Zoom ignores this
+      #   policy.
+      #
+      #   @return [Telnyx::Models::MeetingSessionLeavePolicy, nil]
+      optional :leave_policy, -> { Telnyx::MeetingSessionLeavePolicy }
+
       # @!attribute metadata
       #   Arbitrary key-value metadata attached to the session. The serialized JSON
       #   representation must not exceed 16384 characters at runtime.
@@ -79,12 +90,35 @@ module Telnyx
       #   @return [Hash{Symbol=>Object}, nil]
       optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
+      # @!attribute recording
+      #   Google Meet and Teams only. Defaults to true when recording_export is supplied
+      #   and false otherwise. True requires recording_export.bucket; false cannot be
+      #   combined with recording_export. Fixed at creation, with no pause/resume action.
+      #   Zoom rejects recording, recording_view, and recording_export with 422
+      #   unsupported_capability; omit these fields for Zoom.
+      #
+      #   @return [Boolean, nil]
+      optional :recording, Telnyx::Internal::Type::Boolean
+
+      # @!attribute recording_export
+      #   Customer-owned Telnyx Storage destination for recording exports. Uses the
+      #   authenticated organization and user; do not supply credentials, region,
+      #   organization ID or object key.
+      #
+      #   @return [Telnyx::Models::MeetingSessionRecordingDestination, nil]
+      optional :recording_export, -> { Telnyx::MeetingSessionRecordingDestination }
+
+      # @!attribute recording_view
+      #   Recording layout for Google Meet and Teams. Defaults to speaker_view. Accepted
+      #   at creation only; does not enable recording by itself.
+      #
+      #   @return [Symbol, Telnyx::Models::MeetingSessionCreateParams::RecordingView, nil]
+      optional :recording_view, enum: -> { Telnyx::MeetingSessionCreateParams::RecordingView }
+
       # @!attribute speak_on_enter
-      #   Text the bot speaks when it enters the meeting. **Not spoken when an `assistant`
-      #   is attached**: the value is accepted and echoed back on the session, but the
-      #   assistant owns the voice and the line is never delivered, with no event
-      #   reporting the omission. Use `chat_on_enter` to announce an assistant-backed bot.
-      #   Rejected with 400 `invalid_request` when `assistant.avatar` is `true`.
+      #   Text the bot speaks after joining. Available for sessions without a digital
+      #   avatar. With an AI Assistant, the greeting waits until the assistant is
+      #   connected. Rejected with 400 invalid_request when assistant.avatar is true.
       #
       #   @return [String, nil]
       optional :speak_on_enter, String
@@ -98,7 +132,8 @@ module Telnyx
       # @!attribute voice
       #   Session-default voice identifier used for `speak_on_enter` and ordinary speak
       #   actions. A voice supplied on an individual speak action overrides this default
-      #   for that utterance.
+      #   for that utterance. With an assistant attached, its conversational voice remains
+      #   configured on the assistant.
       #
       #   @return [String, nil]
       optional :voice, String
@@ -111,30 +146,37 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String
 
-      # @!method initialize(meeting_url:, assistant: nil, barge_in: nil, bot_name: nil, camera_image: nil, chat_on_enter: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
+      # @!method initialize(meeting_url:, assistant: nil, barge_in: nil, bot_name: nil, camera_image: nil, chat_on_enter: nil, idempotency_key: nil, join_at: nil, leave_policy: nil, metadata: nil, recording: nil, recording_export: nil, recording_view: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::MeetingSessionCreateParams} for more details.
       #
       #   @param meeting_url [String] The meeting URL the bot should join.
       #
-      #   @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Attach a Telnyx AI Assistant to the session. Supply the Assistant's ID; the Meet
+      #   @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Attach a Telnyx AI Assistant owned by the authenticated account. Supply its ID a
       #
       #   @param barge_in [Boolean] When enabled, a human participant `speech_on` event interrupts and stops the cur
       #
       #   @param bot_name [String] Display name for the bot in the meeting. Defaults to "Meeting Bot".
       #
-      #   @param camera_image [Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource] Write-only static camera-tile image for this session, not a native account or pa
+      #   @param camera_image [Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource] Not supported for Google Meet and Teams joins (422 unsupported_capability). Writ
       #
       #   @param chat_on_enter [String] A message the bot posts to the meeting's chat as soon as it becomes active — typ
       #
-      #   @param idempotency_key [String] Client-supplied idempotency key to safely retry creation requests without duplic
+      #   @param idempotency_key [String] Use a unique key per intended join and reuse the same key and request on retries
       #
-      #   @param join_at [Time] ISO-8601 timestamp in the future at which the bot should join. If omitted, the b
+      #   @param join_at [Time] Future ISO-8601 join timestamp including timezone. Google Meet and Teams accept
+      #
+      #   @param leave_policy [Telnyx::Models::MeetingSessionLeavePolicy] Automatic departure settings for Google Meet and Teams. Omitted fields use the d
       #
       #   @param metadata [Hash{Symbol=>Object}] Arbitrary key-value metadata attached to the session. The serialized JSON repres
       #
-      #   @param speak_on_enter [String] Text the bot speaks when it enters the meeting. \*\*Not spoken when an
-      #   `assistant`
+      #   @param recording [Boolean] Google Meet and Teams only. Defaults to true when recording_export is supplied a
+      #
+      #   @param recording_export [Telnyx::Models::MeetingSessionRecordingDestination] Customer-owned Telnyx Storage destination for recording exports. Uses the authen
+      #
+      #   @param recording_view [Symbol, Telnyx::Models::MeetingSessionCreateParams::RecordingView] Recording layout for Google Meet and Teams. Defaults to speaker_view. Accepted a
+      #
+      #   @param speak_on_enter [String] Text the bot speaks after joining. Available for sessions without a digital avat
       #
       #   @param summarize_on_end [Boolean] If true, generate a summary artifact when the session ends.
       #
@@ -152,12 +194,9 @@ module Telnyx
         required :id, String
 
         # @!attribute audio_gate
-        #   Audio gating strategy for the assistant call leg. `half_duplex` (default) sends
-        #   the assistant a single mixed meeting stream and mutes it while the assistant
-        #   speaks, so the assistant cannot hear itself and cannot be interrupted.
-        #   `full_duplex` sends a separate stream per participant, which allows barge-in and
-        #   removes self-hearing, and COSTS SIGNIFICANTLY MORE: per-participant streams
-        #   multiply the per-minute cost by the number of participants.
+        #   Use half_duplex (default) to pause listening while the assistant speaks, or
+        #   full_duplex to allow participants to interrupt. Full-duplex pricing depends on
+        #   participant audio usage; see the Meeting pricing guide.
         #
         #   @return [Symbol, Telnyx::Models::MeetingSessionCreateParams::Assistant::AudioGate, nil]
         optional :audio_gate, enum: -> { Telnyx::MeetingSessionCreateParams::Assistant::AudioGate }
@@ -167,12 +206,11 @@ module Telnyx
         #   [AI Assistant avatars](/docs/inference/ai-assistants/avatars)) as the bot's
         #   camera, lip-synced to the assistant's own speech. The request carries no avatar
         #   ID or key: the assistant is read at creation and the request is rejected with
-        #   400 `invalid_request` if it has no Telnyx avatar configured. Supported on Google
-        #   Meet, Zoom, Microsoft Teams and Webex; other platforms return 422
-        #   `unsupported_capability`. REST-only. Not echoed back on `assistant`; the
-        #   session's top-level `avatar` and `avatar_state` fields report it instead. If the
-        #   avatar fails, the session continues voice-only and `avatar_state` becomes
-        #   `degraded`.
+        #   400 `invalid_request` if it has no Telnyx avatar configured. Available for
+        #   Google Meet, Zoom, and Teams sessions. REST-only. Not echoed back on
+        #   `assistant`; the session's top-level `avatar` and `avatar_state` fields report
+        #   it instead. If the avatar fails, the session continues voice-only and
+        #   `avatar_state` becomes `degraded`.
         #
         #   @return [Boolean, nil]
         optional :avatar, Telnyx::Internal::Type::Boolean
@@ -185,19 +223,14 @@ module Telnyx
         #   conversation. At most 63 entries; keys 1-128 characters; values must be strings.
         #   The map is budgeted in aggregate at 1,047,552 bytes (1023 KiB) rather than
         #   capped per value. `streaming_audio`, `ai_assistant_streaming_audio` and
-        #   `meeting_session_id` are reserved and rejected with `400 invalid_request` --
-        #   they toggle provider infrastructure or are set by the service rather than fill a
-        #   prompt template.
+        #   `meeting_session_id` are reserved and rejected with `400 invalid_request`.
         #
         #   @return [Hash{Symbol=>String}, nil]
         optional :dynamic_variables, Telnyx::Internal::Type::HashOf[String]
 
         # @!attribute leave_on_end
-        #   Leave the meeting when the Assistant's conversation reaches a terminal state --
-        #   `ended` **or** `failed`. Off by default, which leaves the bot in the meeting
-        #   after the Assistant stops. Fires once: a second terminal transition does not
-        #   leave twice, and a leave the provider refuses is logged without changing how the
-        #   session settles.
+        #   Leave when the assistant conversation ends or fails. Defaults to false. Other
+        #   leave-policy rules and explicit leave requests still apply.
         #
         #   @return [Boolean, nil]
         optional :leave_on_end, Telnyx::Internal::Type::Boolean
@@ -206,27 +239,22 @@ module Telnyx
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::MeetingSessionCreateParams::Assistant} for more details.
         #
-        #   Attach a Telnyx AI Assistant to the session. Supply the Assistant's ID; the
-        #   Meeting service connects it to the meeting directly. The Call Control
-        #   connection, caller ID and loopback SIP URI previously required here have been
-        #   removed and are now rejected as unknown fields.
+        #   Attach a Telnyx AI Assistant owned by the authenticated account. Supply its ID
+        #   and optional conversation settings. Unknown fields are rejected.
         #
         #   @param id [String] Identifier of the assistant to attach.
         #
-        #   @param audio_gate [Symbol, Telnyx::Models::MeetingSessionCreateParams::Assistant::AudioGate] Audio gating strategy for the assistant call leg. `half_duplex` (default) sends
+        #   @param audio_gate [Symbol, Telnyx::Models::MeetingSessionCreateParams::Assistant::AudioGate] Use half_duplex (default) to pause listening while the assistant speaks, or full
         #
         #   @param avatar [Boolean] Beta. Show the avatar configured on the assistant (its `avatar_settings`; see [A
         #
         #   @param dynamic_variables [Hash{Symbol=>String}] Per-conversation values for the [dynamic variables](/docs/inference/ai-assistant
         #
-        #   @param leave_on_end [Boolean] Leave the meeting when the Assistant's conversation reaches a terminal state --
-
-        # Audio gating strategy for the assistant call leg. `half_duplex` (default) sends
-        # the assistant a single mixed meeting stream and mutes it while the assistant
-        # speaks, so the assistant cannot hear itself and cannot be interrupted.
-        # `full_duplex` sends a separate stream per participant, which allows barge-in and
-        # removes self-hearing, and COSTS SIGNIFICANTLY MORE: per-participant streams
-        # multiply the per-minute cost by the number of participants.
+        #   @param leave_on_end [Boolean] Leave when the assistant conversation ends or fails. Defaults to false. Other le
+
+        # Use half_duplex (default) to pause listening while the assistant speaks, or
+        # full_duplex to allow participants to interrupt. Full-duplex pricing depends on
+        # participant audio usage; see the Meeting pricing guide.
         #
         # @see Telnyx::Models::MeetingSessionCreateParams::Assistant#audio_gate
         module AudioGate
@@ -240,12 +268,13 @@ module Telnyx
         end
       end
 
-      # Write-only static camera-tile image for this session, not a native account or
+      # Not supported for Google Meet and Teams joins (422 unsupported_capability).
+      # Write-only static camera-tile image for this session, not an account or
       # participant profile photo. Supply exactly one JPEG source. When effective, the
       # image is used as the bot's static camera/video output; presentation varies by
       # meeting platform and recording configuration and is not guaranteed in
-      # recordings. An effective Avatar or Assistant webpage output takes precedence, so
-      # this input is ignored and a URL source is not fetched.
+      # recordings. An attached assistant or avatar takes precedence, so this input is
+      # ignored and a URL source is not fetched.
       module CameraImage
         extend Telnyx::Internal::Type::Union
 
@@ -259,7 +288,7 @@ module Telnyx
           #   and the URL-safe alphabet are rejected. The encoded value is limited to
           #   1,835,008 characters and the decoded JPEG to 1,363,148 bytes. The JPEG is
           #   limited to 4,096 pixels per dimension, 4 megapixels, and 128 MB of decoder
-          #   memory. The image bytes are not persisted, returned, or logged.
+          #   memory. The image bytes are not returned in the session response.
           #
           #   @return [String]
           required :base64_data, String
@@ -294,8 +323,8 @@ module Telnyx
           #   Fetching is limited to public network destinations, a five-second timeout, no
           #   redirects, a 2xx image/jpeg response with identity or no content encoding, and a
           #   1,363,148-byte limit enforced against both declared and streamed content. The
-          #   service resolves the URL before bot creation and does not persist, return, or
-          #   log the URL or image bytes.
+          #   service resolves the URL before bot creation and does not return the URL or
+          #   image bytes in the session response.
           #
           #   @return [String]
           required :url, String
@@ -313,6 +342,19 @@ module Telnyx
         # @!method self.variants
         #   @return [Array(Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageBase64Source, Telnyx::Models::MeetingSessionCreateParams::CameraImage::MeetingSessionCameraImageURLSource)]
       end
+
+      # Recording layout for Google Meet and Teams. Defaults to speaker_view. Accepted
+      # at creation only; does not enable recording by itself.
+      module RecordingView
+        extend Telnyx::Internal::Type::Enum
+
+        SPEAKER_VIEW = :speaker_view
+        GALLERY_VIEW = :gallery_view
+        SPEAKER_VIEW_NO_SIDEBAR = :speaker_view_no_sidebar
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/telnyx/models/meeting_session_leave_policy.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class MeetingSessionLeavePolicy < Telnyx::Internal::Type::BaseModel
+      # @!attribute alone_seconds
+      #   Seconds alone after another participant has attended and left. Does not start
+      #   just because the bot arrives first.
+      #
+      #   @return [Integer, nil]
+      optional :alone_seconds, Integer
+
+      # @!attribute bot_name_keywords
+      #   Case-insensitive names or phrases identifying other bots to exclude when
+      #   deciding whether this bot is alone. Matching splits names on spaces, hyphens and
+      #   underscores. Null or an empty array disables filtering.
+      #
+      #   @return [Array<String>, nil]
+      optional :bot_name_keywords, Telnyx::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute host_wait_seconds
+      #   Seconds to wait for the host to start the meeting.
+      #
+      #   @return [Integer, nil]
+      optional :host_wait_seconds, Integer
+
+      # @!attribute lobby_wait_seconds
+      #   Seconds to wait for lobby admission.
+      #
+      #   @return [Integer, nil]
+      optional :lobby_wait_seconds, Integer
+
+      # @!attribute max_duration_seconds
+      #   Maximum seconds after joining. Null means no per-join duration limit; service
+      #   safety limits still apply.
+      #
+      #   @return [Integer, nil]
+      optional :max_duration_seconds, Integer, nil?: true
+
+      # @!attribute silence_grace_seconds
+      #   Seconds after joining before silence detection starts a fresh inactivity timer.
+      #
+      #   @return [Integer, nil]
+      optional :silence_grace_seconds, Integer
+
+      # @!attribute silence_seconds
+      #   Continuous audio inactivity before departure after the silence grace period.
+      #
+      #   @return [Integer, nil]
+      optional :silence_seconds, Integer
+
+      # @!method initialize(alone_seconds: nil, bot_name_keywords: nil, host_wait_seconds: nil, lobby_wait_seconds: nil, max_duration_seconds: nil, silence_grace_seconds: nil, silence_seconds: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::MeetingSessionLeavePolicy} for more details.
+      #
+      #   Automatic departure settings for Google Meet and Teams. Omitted fields use the
+      #   default behavior. Set at creation; cannot be changed later. Zoom ignores this
+      #   policy.
+      #
+      #   @param alone_seconds [Integer] Seconds alone after another participant has attended and left. Does not start ju
+      #
+      #   @param bot_name_keywords [Array<String>, nil] Case-insensitive names or phrases identifying other bots to exclude when decidin
+      #
+      #   @param host_wait_seconds [Integer] Seconds to wait for the host to start the meeting.
+      #
+      #   @param lobby_wait_seconds [Integer] Seconds to wait for lobby admission.
+      #
+      #   @param max_duration_seconds [Integer, nil] Maximum seconds after joining. Null means no per-join duration limit; service sa
+      #
+      #   @param silence_grace_seconds [Integer] Seconds after joining before silence detection starts a fresh inactivity timer.
+      #
+      #   @param silence_seconds [Integer] Continuous audio inactivity before departure after the silence grace period.
+    end
+  end
+end

data/lib/telnyx/models/meeting_session_recording_destination.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class MeetingSessionRecordingDestination < Telnyx::Internal::Type::BaseModel
+      # @!attribute bucket
+      #   Existing accessible bucket. Consecutive dots and IPv4-address names are
+      #   rejected.
+      #
+      #   @return [String]
+      required :bucket, String
+
+      # @!attribute prefix
+      #   Optional object-key prefix. One trailing slash is normalized. Empty path
+      #   segments, . and .. segments are rejected.
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!method initialize(bucket:, prefix: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::MeetingSessionRecordingDestination} for more details.
+      #
+      #   Customer-owned Telnyx Storage destination for recording exports. Uses the
+      #   authenticated organization and user; do not supply credentials, region,
+      #   organization ID or object key.
+      #
+      #   @param bucket [String] Existing accessible bucket. Consecutive dots and IPv4-address names are rejected
+      #
+      #   @param prefix [String] Optional object-key prefix. One trailing slash is normalized. Empty path segment
+    end
+  end
+end

data/lib/telnyx/models/meeting_session_recording_export.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class MeetingSessionRecordingExport < Telnyx::Internal::Type::BaseModel
+      # @!attribute bucket
+      #
+      #   @return [String]
+      required :bucket, String
+
+      # @!attribute bytes
+      #
+      #   @return [Integer, nil]
+      required :bytes, Integer, nil?: true
+
+      # @!attribute exported_at
+      #
+      #   @return [Time, nil]
+      required :exported_at, Time, nil?: true
+
+      # @!attribute key
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!attribute region
+      #
+      #   @return [String]
+      required :region, String
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Telnyx::Models::MeetingSessionRecordingExport::Status]
+      required :status, enum: -> { Telnyx::MeetingSessionRecordingExport::Status }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :video]
+      required :type, const: :video
+
+      # @!method initialize(bucket:, bytes:, exported_at:, key:, region:, status:, type: :video)
+      #   Customer Storage recording reference. Pending is not downloadable; exported
+      #   means upload was verified; failed is terminal. Download with ordinary Storage
+      #   authorization. No presigned URL is returned.
+      #
+      #   @param bucket [String]
+      #   @param bytes [Integer, nil]
+      #   @param exported_at [Time, nil]
+      #   @param key [String]
+      #   @param region [String]
+      #   @param status [Symbol, Telnyx::Models::MeetingSessionRecordingExport::Status]
+      #   @param type [Symbol, :video]
+
+      # @see Telnyx::Models::MeetingSessionRecordingExport#status
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        PENDING = :pending
+        EXPORTED = :exported
+        FAILED = :failed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/meeting_session_response.rb

@@ -5,9 +5,9 @@ module Telnyx
     # @see Telnyx::Resources::MeetingSessions#create
     class MeetingSessionResponse < Telnyx::Internal::Type::BaseModel
       # @!attribute data
-      #   Represents a meeting session. All serializer fields are present and required;
-      #   nullable fields use null when absent. No actor, provider-bot, idempotency,
-      #   routing, key, or internal fields are exposed.
+      #   Represents a meeting session. Core serializer fields are required;
+      #   platform-specific fields are optional. Nullable fields use null when absent. No
+      #   actor, provider-bot, idempotency, routing, key, or internal fields are exposed.
       #
       #   @return [Telnyx::Models::MeetingSession]
       required :data, -> { Telnyx::MeetingSession }
@@ -16,7 +16,7 @@ module Telnyx
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::MeetingSessionResponse} for more details.
       #
-      #   @param data [Telnyx::Models::MeetingSession] Represents a meeting session. All serializer fields are present and required; nu
+      #   @param data [Telnyx::Models::MeetingSession] Represents a meeting session. Core serializer fields are required; platform-spec
     end
   end
 end

data/lib/telnyx/models/meeting_session_retrieve_recordings_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::MeetingSessions#retrieve_recordings
+    class MeetingSessionRetrieveRecordingsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/meeting_session_retrieve_recordings_response.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::MeetingSessions#retrieve_recordings
+    class MeetingSessionRetrieveRecordingsResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #   Temporary download URLs for recordings held by the Meeting service, including
+      #   Zoom and existing Google Meet and Teams recordings. Empty for customer Storage
+      #   exports; use recording_export instead. Choose the download method from these
+      #   fields rather than the platform alone.
+      #
+      #   @return [Array<Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data>]
+      required :data,
+               -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data] }
+
+      # @!attribute recording_export
+      #   Customer Storage recording reference. Pending is not downloadable; exported
+      #   means upload was verified; failed is terminal. Download with ordinary Storage
+      #   authorization. No presigned URL is returned.
+      #
+      #   @return [Telnyx::Models::MeetingSessionRecordingExport, nil]
+      optional :recording_export, -> { Telnyx::MeetingSessionRecordingExport }, nil?: true
+
+      # @!method initialize(data:, recording_export: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::MeetingSessionRetrieveRecordingsResponse} for more details.
+      #
+      #   @param data [Array<Telnyx::Models::MeetingSessionRetrieveRecordingsResponse::Data>] Temporary download URLs for recordings held by the Meeting service, including Zo
+      #
+      #   @param recording_export [Telnyx::Models::MeetingSessionRecordingExport, nil] Customer Storage recording reference. Pending is not downloadable; exported mean
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute expires_at
+        #
+        #   @return [Time, nil]
+        required :expires_at, Time, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute url
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(expires_at:, type:, url:)
+        #   @param expires_at [Time, nil]
+        #   @param type [String]
+        #   @param url [String]
+      end
+    end
+  end
+end

data/lib/telnyx/models/meeting_session_retrieve_transcript_response.rb

@@ -36,11 +36,16 @@ module Telnyx
         required :relative_ts, Float, nil?: true
 
         # @!attribute seq
+        #   Monotonic transcript append cursor. This is separate from the event-history
+        #   cursor and does not establish conversational turn order.
         #
         #   @return [Integer]
         required :seq, Integer
 
         # @!attribute speaker_label
+        #   Recorded participant or bot label, or null when unavailable. Labels are
+        #   attribution, not verified identity. Segments from concurrent speakers can
+        #   finalize in a different order from the conversation.
         #
         #   @return [String, nil]
         required :speaker_label, String, nil?: true
@@ -51,11 +56,20 @@ module Telnyx
         required :text, String
 
         # @!method initialize(confidence:, occurred_at:, relative_ts:, seq:, speaker_label:, text:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::MeetingSessionRetrieveTranscriptResponse::Data} for more
+        #   details.
+        #
         #   @param confidence [Float, nil]
+        #
         #   @param occurred_at [Time]
+        #
         #   @param relative_ts [Float, nil]
-        #   @param seq [Integer]
-        #   @param speaker_label [String, nil]
+        #
+        #   @param seq [Integer] Monotonic transcript append cursor. This is separate from the event-history curs
+        #
+        #   @param speaker_label [String, nil] Recorded participant or bot label, or null when unavailable. Labels are attribut
+        #
         #   @param text [String]
       end