telnyx 5.160.0 → 5.161.0

data/lib/telnyx/resources/meeting_sessions.rb

@@ -0,0 +1,290 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class MeetingSessions
+      # Send real-time speech and chat actions to an active meeting session.
+      # @return [Telnyx::Resources::MeetingSessions::Actions]
+      attr_reader :actions
+
+      # Create and retrieve asynchronous summaries and action-item artifacts.
+      # @return [Telnyx::Resources::MeetingSessions::Artifacts]
+      attr_reader :artifacts
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::MeetingSessionCreateParams} for more details.
+      #
+      # Creates a new meeting session. When an idempotency_key is supplied in the
+      # request body, replay lookup is scoped to the authenticated account and compares
+      # only the key; the request payload is not fingerprinted or compared. If a session
+      # with that key already exists for the account, the existing session is replayed
+      # (200); otherwise a new session is created (201). Supports bring-your-own-key
+      # (BYOK) configuration. The session may enter asynchronous states (e.g. joining,
+      # waiting_for_admission) before becoming active. Optional `camera_image` input is
+      # write-only and applies only when no Avatar or Assistant webpage output takes
+      # precedence. An ignored URL is not fetched. An effective URL source is resolved
+      # before bot creation; neither the source URL nor image bytes are persisted,
+      # returned, or logged. Treat signed URLs as credentials.
+      #
+      # @overload create(meeting_url:, assistant: nil, avatar: nil, barge_in: nil, bot_name: nil, camera_image: nil, idempotency_key: nil, join_at: nil, metadata: nil, speak_on_enter: nil, summarize_on_end: nil, voice: nil, webhook_url: nil, request_options: {})
+      #
+      # @param meeting_url [String] The meeting URL the bot should join.
+      #
+      # @param assistant [Telnyx::Models::MeetingSessionCreateParams::Assistant] Request options for attaching a voice assistant to the session. Routing fields (
+      #
+      # @param avatar [Telnyx::Models::MeetingSessionCreateParams::Avatar] Request options for attaching a bring-your-own-key avatar to the session.
+      #
+      # @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 idempotency_key [String] Client-supplied idempotency key to safely retry creation requests without duplic
+      #
+      # @param join_at [Time] ISO-8601 timestamp in the future at which the bot should join. If omitted, the b
+      #
+      # @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.
+      #
+      # @param summarize_on_end [Boolean] If true, generate a summary artifact when the session ends.
+      #
+      # @param voice [String] Session-default voice identifier used for `speak_on_enter` and ordinary speak ac
+      #
+      # @param webhook_url [String] HTTPS endpoint to receive session lifecycle callbacks. Static validation require
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionCreateParams
+      def create(params)
+        parsed, options = Telnyx::MeetingSessionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "meeting_sessions",
+          body: parsed,
+          model: Telnyx::MeetingSessionResponse,
+          options: options
+        )
+      end
+
+      # Retrieves a single meeting session by ID. A session that does not exist or that
+      # belongs to a different account both return 404.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["meeting_sessions/%1$s", id],
+          model: Telnyx::MeetingSessionResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Updates mutable properties of a meeting session. Only sessions in the scheduled
+      # state can be updated; any other state returns 409 with the invalid_state error
+      # code. All request fields are optional, and an empty object is a valid no-op
+      # update.
+      #
+      # @overload update(id, bot_name: nil, join_at: nil, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param bot_name [String] Updated display name for the bot.
+      #
+      # @param join_at [Time] ISO-8601 timestamp for the bot to join. May be updated to reschedule.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionUpdateParams
+      def update(id, params = {})
+        parsed, options = Telnyx::MeetingSessionUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["meeting_sessions/%1$s", id],
+          body: parsed,
+          model: Telnyx::MeetingSessionResponse,
+          options: options
+        )
+      end
+
+      # Returns a list of meeting sessions, optionally filtered by status.
+      #
+      # @overload list(status: nil, request_options: {})
+      #
+      # @param status [Symbol, Telnyx::Models::MeetingSessionListParams::Status] Filter meeting sessions by current status.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionListResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionListParams
+      def list(params = {})
+        parsed, options = Telnyx::MeetingSessionListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "meeting_sessions",
+          query: query,
+          model: Telnyx::Models::MeetingSessionListResponse,
+          options: options
+        )
+      end
+
+      # Stops a meeting session without deleting its persisted record. Scheduled bots
+      # are cancelled, while bots that are joining or active are asked to leave. The
+      # persisted meeting session record remains available.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["meeting_sessions/%1$s", id],
+          model: Telnyx::MeetingSessionResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # **Not yet available in production** — this route is not currently routed on
+      # api.telnyx.com and returns a generic 404; it is documented ahead of rollout.
+      # Irreversibly requests deletion of provider-hosted aggregate recording media
+      # under the provider contract. The operation retains the Telnyx-local Meeting
+      # session, transcript segments, events, artifacts, and usage records. It is
+      # separate from `DELETE /meeting_sessions/{id}`, which stops or cancels
+      # participation without deleting the persisted session. A missing/foreign session
+      # returns 404; provider deletion failures return 502.
+      #
+      # @overload delete_recording_media(id, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionDeleteRecordingMediaResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionDeleteRecordingMediaParams
+      def delete_recording_media(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["meeting_sessions/%1$s/recording_media", id],
+          model: Telnyx::Models::MeetingSessionDeleteRecordingMediaResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns stored events ordered by ascending `seq`. To continue, pass the last
+      # returned item's `seq` as `after`. An empty page means no later stored events
+      # existed at read time; this operation returns no separate next-page cursor.
+      # Default `limit` is 100 and maximum is 1,000.
+      #
+      # @overload retrieve_events(id, after: nil, limit: nil, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param after [Integer] Return results with a cursor position after this value.
+      #
+      # @param limit [Integer] Maximum number of results to return per page.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionRetrieveEventsResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionRetrieveEventsParams
+      def retrieve_events(id, params = {})
+        parsed, options = Telnyx::MeetingSessionRetrieveEventsParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["meeting_sessions/%1$s/events", id],
+          query: query,
+          model: Telnyx::Models::MeetingSessionRetrieveEventsResponse,
+          options: options
+        )
+      end
+
+      # Returns recordings for a meeting session.
+      #
+      # @overload retrieve_recordings(id, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionRetrieveRecordingsResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionRetrieveRecordingsParams
+      def retrieve_recordings(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["meeting_sessions/%1$s/recordings", id],
+          model: Telnyx::Models::MeetingSessionRetrieveRecordingsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::MeetingSessionRetrieveTranscriptParams} for more details.
+      #
+      # Returns transcript segments ordered by ascending `seq`. Default `limit` is 100
+      # and maximum is 1,000. Continue with `after=meta.next_after`. A long-poll timeout
+      # returns 200 with empty `data` and `meta.next_after: null`; retain the cursor
+      # supplied to that request because null is not a replacement cursor.
+      #
+      # @overload retrieve_transcript(id, after: nil, limit: nil, wait_seconds: nil, request_options: {})
+      #
+      # @param id [String] Unique identifier for the meeting session.
+      #
+      # @param after [Integer] Return results with a cursor position after this value.
+      #
+      # @param limit [Integer] Maximum number of results to return per page.
+      #
+      # @param wait_seconds [Integer] Long-poll duration in seconds. The server holds the connection open for up to th
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MeetingSessionRetrieveTranscriptResponse]
+      #
+      # @see Telnyx::Models::MeetingSessionRetrieveTranscriptParams
+      def retrieve_transcript(id, params = {})
+        parsed, options = Telnyx::MeetingSessionRetrieveTranscriptParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["meeting_sessions/%1$s/transcript", id],
+          query: query,
+          model: Telnyx::Models::MeetingSessionRetrieveTranscriptResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @actions = Telnyx::Resources::MeetingSessions::Actions.new(client: client)
+        @artifacts = Telnyx::Resources::MeetingSessions::Artifacts.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/phone_numbers/voicemail.rb

@@ -5,14 +5,22 @@ module Telnyx
     class PhoneNumbers
       # Voicemail API
       class Voicemail
-        # Create voicemail settings for a phone number
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::PhoneNumbers::VoicemailCreateParams} for more details.
         #
-        # @overload create(phone_number_id, enabled: nil, pin: nil, request_options: {})
+        # Create voicemail settings for a phone number. You can also configure a custom
+        # greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+        # with a `media_name` that points to an audio file uploaded through the Media
+        # Storage API, or `mode` `default` to use the standard system greeting.
+        #
+        # @overload create(phone_number_id, enabled: nil, greeting: nil, pin: nil, request_options: {})
         #
         # @param phone_number_id [String] The ID of the phone number.
         #
         # @param enabled [Boolean] Whether voicemail is enabled.
         #
+        # @param greeting [Telnyx::Models::PhoneNumbers::VoicemailRequest::Greeting] Controls the greeting a caller hears before leaving a voicemail. Set `mode` to `
+        #
         # @param pin [String] The pin used for voicemail
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -51,14 +59,22 @@ module Telnyx
           )
         end
 
-        # Update voicemail settings for a phone number
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::PhoneNumbers::VoicemailUpdateParams} for more details.
         #
-        # @overload update(phone_number_id, enabled: nil, pin: nil, request_options: {})
+        # Update voicemail settings for a phone number. You can also configure a custom
+        # greeting by setting the `greeting` object: use `mode` `custom_greeting` together
+        # with a `media_name` that points to an audio file uploaded through the Media
+        # Storage API, or `mode` `default` to use the standard system greeting.
+        #
+        # @overload update(phone_number_id, enabled: nil, greeting: nil, pin: nil, request_options: {})
         #
         # @param phone_number_id [String] The ID of the phone number.
         #
         # @param enabled [Boolean] Whether voicemail is enabled.
         #
+        # @param greeting [Telnyx::Models::PhoneNumbers::VoicemailRequest::Greeting] Controls the greeting a caller hears before leaving a voicemail. Set `mode` to `
+        #
         # @param pin [String] The pin used for voicemail
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/telnyx/resources/sim_cards/actions.rb

@@ -87,6 +87,9 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::SimCards::ActionBulkEnableVoiceParams} for more details.
+        #
         # This API triggers an asynchronous operation to enable voice on SIM cards
         # belonging to a specified SIM Card Group.<br/> For each SIM Card a SIM Card
         # Action will be generated. The status of the SIM Card Actions can be followed
@@ -98,9 +101,12 @@ module Telnyx
         # [List Bulk SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-bulk-sim-card-actions)
         # API.
         #
-        # @overload bulk_enable_voice(sim_card_group_id:, request_options: {})
+        # @overload bulk_enable_voice(sim_card_group_id:, connection_id: nil, request_options: {})
         #
         # @param sim_card_group_id [String]
+        #
+        # @param connection_id [String] The identifier of the Mobile Voice Connection to associate with the SIM cards. T
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::SimCards::ActionBulkEnableVoiceResponse]
@@ -167,6 +173,31 @@ module Telnyx
           )
         end
 
+        # This API disables voice calling on a SIM card. The SIM card will no longer be
+        # able to make or receive calls.<br/> The API will trigger an asynchronous
+        # operation called a SIM Card Action. The status of the SIM Card Action can be
+        # followed through the
+        # [List SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-sim-card-actions)
+        # API.
+        #
+        # @overload disable_voice(id, request_options: {})
+        #
+        # @param id [String] Identifies the SIM.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::SimCards::ActionDisableVoiceResponse]
+        #
+        # @see Telnyx::Models::SimCards::ActionDisableVoiceParams
+        def disable_voice(id, params = {})
+          @client.request(
+            method: :post,
+            path: ["sim_cards/%1$s/actions/disable_voice", id],
+            model: Telnyx::Models::SimCards::ActionDisableVoiceResponse,
+            options: params[:request_options]
+          )
+        end
+
         # This API enables a SIM card, connecting it to the network and making it possible
         # to consume data.<br/> To enable a SIM card, it must be associated with a SIM
         # card group.<br/> The API will trigger an asynchronous operation called a SIM
@@ -193,6 +224,40 @@ module Telnyx
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::SimCards::ActionEnableVoiceParams} for more details.
+        #
+        # This API enables voice calling on a SIM card. When a <code>connection_id</code>
+        # is provided, the SIM is associated with the specified Mobile Voice Connection.
+        # The connection must be owned by the same user and of type
+        # <code>mobile_voice</code>.<br/> The API will trigger an asynchronous operation
+        # called a SIM Card Action. The status of the SIM Card Action can be followed
+        # through the
+        # [List SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-sim-card-actions)
+        # API.
+        #
+        # @overload enable_voice(id, connection_id: nil, request_options: {})
+        #
+        # @param id [String] Identifies the SIM.
+        #
+        # @param connection_id [String] The identifier of the Mobile Voice Connection to associate with this SIM card. T
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::SimCards::ActionEnableVoiceResponse]
+        #
+        # @see Telnyx::Models::SimCards::ActionEnableVoiceParams
+        def enable_voice(id, params = {})
+          parsed, options = Telnyx::SimCards::ActionEnableVoiceParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["sim_cards/%1$s/actions/enable_voice", id],
+            body: parsed,
+            model: Telnyx::Models::SimCards::ActionEnableVoiceResponse,
+            options: options
+          )
+        end
+
         # This API removes an existing public IP from a SIM card. <br/><br/> The API will
         # trigger an asynchronous operation called a SIM Card Action. The status of the
         # SIM Card Action can be followed through the

data/lib/telnyx/resources/storage/sqldbs/actions.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Storage
+      class Sqldbs
+        # Manage SQL databases and run SQL against them
+        class Actions
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Storage::Sqldbs::ActionQueryParams} for more details.
+          #
+          # Runs SQL against the database and returns the resulting rows — empty for
+          # statements that return none, such as DDL. Bind positional `?` placeholders with
+          # `params` rather than interpolating values into the SQL string.
+          #
+          # @overload query(id, sql:, params: nil, request_options: {})
+          #
+          # @param id [String] SQL database ID
+          #
+          # @param sql [String] The SQL to run. Use positional `?` placeholders and supply the values in `params
+          #
+          # @param params [Array<String, Float, Boolean, nil>] Positional bind parameters, in placeholder order. Each value is a string, a numb
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Storage::Sqldbs::ActionQueryResponse]
+          #
+          # @see Telnyx::Models::Storage::Sqldbs::ActionQueryParams
+          def query(id, params)
+            parsed, options = Telnyx::Storage::Sqldbs::ActionQueryParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["storage/sqldbs/%1$s/actions/query", id],
+              body: parsed,
+              model: Telnyx::Models::Storage::Sqldbs::ActionQueryResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/storage/sqldbs.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Storage
+      # Manage SQL databases and run SQL against them
+      class Sqldbs
+        # Manage SQL databases and run SQL against them
+        # @return [Telnyx::Resources::Storage::Sqldbs::Actions]
+        attr_reader :actions
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Storage::SqldbCreateParams} for more details.
+        #
+        # Creates a new SQL database. Provisioning is asynchronous: the database is
+        # returned with status `pending` and becomes usable once it reaches
+        # `provision_ok`.
+        #
+        # @overload create(name:, request_options: {})
+        #
+        # @param name [String] Database name. Lowercase letters, numbers, and hyphens only; must start and end
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::SqlDatabaseResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::SqldbCreateParams
+        def create(params)
+          parsed, options = Telnyx::Storage::SqldbCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "storage/sqldbs",
+            body: parsed,
+            model: Telnyx::Storage::SqlDatabaseResponseWrapper,
+            options: options
+          )
+        end
+
+        # Retrieves a SQL database by its ID, including its provisioning status.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] SQL database ID
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Storage::SqlDatabaseResponseWrapper]
+        #
+        # @see Telnyx::Models::Storage::SqldbRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["storage/sqldbs/%1$s", id],
+            model: Telnyx::Storage::SqlDatabaseResponseWrapper,
+            options: params[:request_options]
+          )
+        end
+
+        # Lists the SQL databases for the authenticated user's organization. Results use
+        # page-based pagination (`page[number]`/`page[size]`) and can be filtered and
+        # sorted.
+        #
+        # @overload list(filter_name: nil, filter_status: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
+        #
+        # @param filter_name [String] Filter by exact name match.
+        #
+        # @param filter_status [Symbol, Telnyx::Models::Storage::SqldbListParams::FilterStatus] Filter by provisioning status.
+        #
+        # @param page_number [Integer] The page number to load.
+        #
+        # @param page_size [Integer] The size of the page. Values above 250 are treated as 250.
+        #
+        # @param sort [Symbol, Telnyx::Models::Storage::SqldbListParams::Sort] Sort field; prefix with `-` for descending order.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Storage::SqlDatabase>]
+        #
+        # @see Telnyx::Models::Storage::SqldbListParams
+        def list(params = {})
+          parsed, options = Telnyx::Storage::SqldbListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "storage/sqldbs",
+            query: query.transform_keys(
+              filter_name: "filter[name]",
+              filter_status: "filter[status]",
+              page_number: "page[number]",
+              page_size: "page[size]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Storage::SqlDatabase,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Storage::SqldbDeleteParams} for more details.
+        #
+        # Deletes a SQL database and all of the data it holds. Deletion is asynchronous
+        # and returns `202` with an empty body — the record is not removed synchronously.
+        # Poll `GET /storage/sqldbs/{id}`, which returns `404` once the database has been
+        # purged; there is no durable `deleted` state. A database still bound by a
+        # function is refused with `409` unless `force=true`.
+        #
+        # @overload delete(id, force: nil, request_options: {})
+        #
+        # @param id [String] SQL database ID
+        #
+        # @param force [Boolean] Delete the database even when functions still bind it. Their bindings stop resol
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Telnyx::Models::Storage::SqldbDeleteParams
+        def delete(id, params = {})
+          parsed, options = Telnyx::Storage::SqldbDeleteParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :delete,
+            path: ["storage/sqldbs/%1$s", id],
+            query: query,
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @actions = Telnyx::Resources::Storage::Sqldbs::Actions.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/storage.rb

@@ -25,6 +25,10 @@ module Telnyx
       # @return [Telnyx::Resources::Storage::Cloudfs]
       attr_reader :cloudfs
 
+      # Manage SQL databases and run SQL against them
+      # @return [Telnyx::Resources::Storage::Sqldbs]
+      attr_reader :sqldbs
+
       # List the external storage providers and regions supported as migration sources.
       #
       # @overload list_migration_source_coverage(request_options: {})
@@ -53,6 +57,7 @@ module Telnyx
         @migrations = Telnyx::Resources::Storage::Migrations.new(client: client)
         @kvs = Telnyx::Resources::Storage::Kvs.new(client: client)
         @cloudfs = Telnyx::Resources::Storage::Cloudfs.new(client: client)
+        @sqldbs = Telnyx::Resources::Storage::Sqldbs.new(client: client)
       end
     end
   end