telnyx 5.171.0 → 5.174.0

data/lib/telnyx/resources/pay_connectors.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Generic payment connector configuration.
+    class PayConnectors
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::PayConnectorCreateParams} for more details.
+      #
+      # Create a generic payment connector in the authenticated organization. The name
+      # must be unique in that organization. Authentication supplies ownership; do not
+      # send user_id or organization_id. Config is encrypted at rest; passwords and
+      # tokens are omitted from responses. This operation stores configuration and does
+      # not initiate a payment. See the
+      # [processor contract](/docs/voice/programmable-voice/pay#request-sent-to-the-payment-processor).
+      #
+      # @overload create(config:, name:, mode: nil, type: nil, request_options: {})
+      #
+      # @param config [Telnyx::Models::GenericPayConnectorConfig::BasicAuthenticationAlsoTheValidationDefault, Telnyx::Models::GenericPayConnectorConfig::BearerAuthentication, Telnyx::Models::GenericPayConnectorConfig::NoProcessorAuthentication] Configuration for a generic connector. A config update replaces the complete obj
+      #
+      # @param name [String] Unique within the authenticated organization. Used in resource paths and as conn
+      #
+      # @param mode [Symbol, Telnyx::Models::PayConnectorCreateParams::Mode] Defaults to test on creation. Test restricts collected card numbers but still co
+      #
+      # @param type [Symbol, Telnyx::Models::PayConnectorCreateParams::Type] Connector type covered by this reference.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::PayConnectorResponse]
+      #
+      # @see Telnyx::Models::PayConnectorCreateParams
+      def create(params)
+        parsed, options = Telnyx::PayConnectorCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "pay_connectors",
+          body: parsed,
+          model: Telnyx::PayConnectorResponse,
+          options: options
+        )
+      end
+
+      # Retrieve a connector by name within the authenticated organization. Password and
+      # token are omitted. A missing name or a connector owned by another organization
+      # returns 404.
+      #
+      # @overload retrieve(name, request_options: {})
+      #
+      # @param name [String] Connector name, not its UUID. URL-encode the name as a path segment.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::PayConnectorResponse]
+      #
+      # @see Telnyx::Models::PayConnectorRetrieveParams
+      def retrieve(name, params = {})
+        @client.request(
+          method: :get,
+          path: ["pay_connectors/%1$s", name],
+          model: Telnyx::PayConnectorResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::PayConnectorUpdateParams} for more details.
+      #
+      # Update a generic connector by name in the authenticated organization. Both test
+      # and live connectors can be updated through the API. Omitted fields remain
+      # unchanged. Supplying config replaces the entire config; it does not merge keys.
+      # Include endpoint_url and the credentials required for the selected auth_type on
+      # every config replacement. Omitting config preserves existing credentials,
+      # allowing a mode-only update. The path name cannot be renamed. Public updates use
+      # PATCH.
+      #
+      # @overload update(name, config: nil, mode: nil, type: nil, request_options: {})
+      #
+      # @param name [String] Connector name, not its UUID. URL-encode the name as a path segment.
+      #
+      # @param config [Telnyx::Models::GenericPayConnectorConfig::BasicAuthenticationAlsoTheValidationDefault, Telnyx::Models::GenericPayConnectorConfig::BearerAuthentication, Telnyx::Models::GenericPayConnectorConfig::NoProcessorAuthentication] Configuration for a generic connector. A config update replaces the complete obj
+      #
+      # @param mode [Symbol, Telnyx::Models::PayConnectorUpdateParams::Mode] Omit to preserve the existing mode. Use an explicit test or live value.
+      #
+      # @param type [Symbol, Telnyx::Models::PayConnectorUpdateParams::Type] Generic connector type. Omit to preserve the existing value.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::PayConnectorResponse]
+      #
+      # @see Telnyx::Models::PayConnectorUpdateParams
+      def update(name, params = {})
+        parsed, options = Telnyx::PayConnectorUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["pay_connectors/%1$s", name],
+          body: parsed,
+          model: Telnyx::PayConnectorResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::PayConnectorListParams} for more details.
+      #
+      # List connectors belonging to the authenticated organization, including
+      # connectors created by other users in that organization. Set filter[type]=generic
+      # to restrict results to the type covered here. Results default to newest
+      # created_at first. Use meta.end_cursor as page[after] for the next page, or
+      # meta.start_cursor as page[before] for the preceding page. Omit both cursors for
+      # the first page; if both are supplied, page[after] takes precedence. Responses
+      # omit passwords and tokens.
+      #
+      # @overload list(filter_created_at_eq: nil, filter_created_at_gt: nil, filter_created_at_gte: nil, filter_created_at_lt: nil, filter_created_at_lte: nil, filter_mode: nil, filter_name: nil, filter_type: nil, filter_updated_at_eq: nil, filter_updated_at_gt: nil, filter_updated_at_gte: nil, filter_updated_at_lt: nil, filter_updated_at_lte: nil, page_after: nil, page_before: nil, page_size: nil, sort: nil, request_options: {})
+      #
+      # @param filter_created_at_eq [String] Equal to this created_at timestamp.
+      #
+      # @param filter_created_at_gt [String] After this created_at timestamp.
+      #
+      # @param filter_created_at_gte [String] At or after this created_at timestamp.
+      #
+      # @param filter_created_at_lt [String] Before this created_at timestamp.
+      #
+      # @param filter_created_at_lte [String] At or before this created_at timestamp.
+      #
+      # @param filter_mode [String] Exact match on mode.
+      #
+      # @param filter_name [String] Exact match on name.
+      #
+      # @param filter_type [String] Exact match on type.
+      #
+      # @param filter_updated_at_eq [String] Equal to this updated_at timestamp.
+      #
+      # @param filter_updated_at_gt [String] After this updated_at timestamp.
+      #
+      # @param filter_updated_at_gte [String] At or after this updated_at timestamp.
+      #
+      # @param filter_updated_at_lt [String] Before this updated_at timestamp.
+      #
+      # @param filter_updated_at_lte [String] At or before this updated_at timestamp.
+      #
+      # @param page_after [String] Opaque cursor from meta.end_cursor.
+      #
+      # @param page_before [String] Opaque cursor from meta.start_cursor.
+      #
+      # @param page_size [Integer] Number of records per page.
+      #
+      # @param sort [String] Comma-separated created_at or updated_at fields, optionally prefixed with - for
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::EmailBracketCursorPagination<Telnyx::Models::PayConnector>]
+      #
+      # @see Telnyx::Models::PayConnectorListParams
+      def list(params = {})
+        parsed, options = Telnyx::PayConnectorListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "pay_connectors",
+          query: query.transform_keys(
+            filter_created_at_eq: "filter[created_at][eq]",
+            filter_created_at_gt: "filter[created_at][gt]",
+            filter_created_at_gte: "filter[created_at][gte]",
+            filter_created_at_lt: "filter[created_at][lt]",
+            filter_created_at_lte: "filter[created_at][lte]",
+            filter_mode: "filter[mode]",
+            filter_name: "filter[name]",
+            filter_type: "filter[type]",
+            filter_updated_at_eq: "filter[updated_at][eq]",
+            filter_updated_at_gt: "filter[updated_at][gt]",
+            filter_updated_at_gte: "filter[updated_at][gte]",
+            filter_updated_at_lt: "filter[updated_at][lt]",
+            filter_updated_at_lte: "filter[updated_at][lte]",
+            page_after: "page[after]",
+            page_before: "page[before]",
+            page_size: "page[size]"
+          ),
+          page: Telnyx::Internal::EmailBracketCursorPagination,
+          model: Telnyx::PayConnector,
+          options: options
+        )
+      end
+
+      # Delete a connector by name in the authenticated organization. Both test and live
+      # connectors can be deleted. Returns no response body on success; a missing name
+      # or a connector in another organization returns 404.
+      #
+      # @overload delete(name, request_options: {})
+      #
+      # @param name [String] Connector name, not its UUID. URL-encode the name as a path segment.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Telnyx::Models::PayConnectorDeleteParams
+      def delete(name, params = {})
+        @client.request(
+          method: :delete,
+          path: ["pay_connectors/%1$s", name],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

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

@@ -11,12 +11,14 @@ module Telnyx
         # filters. The `csv_format` parameter selects the output format, and the response
         # contains the resulting download record.
         #
-        # @overload create(csv_format: nil, filter: nil, request_options: {})
+        # @overload create(csv_format: nil, filter: nil, include_managed_accounts: nil, request_options: {})
         #
         # @param csv_format [Symbol, Telnyx::Models::PhoneNumbers::CsvDownloadCreateParams::CsvFormat] Which format to use when generating the CSV file. The default for backwards comp
         #
         # @param filter [Telnyx::Models::PhoneNumbers::CsvDownloadCreateParams::Filter] Consolidated filter parameter (deepObject style). Originally: filter[has_bundle]
         #
+        # @param include_managed_accounts [Boolean] When true, the CSV includes phone numbers from all managed accounts in addition
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::PhoneNumbers::CsvDownloadCreateResponse]

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

@@ -47,7 +47,7 @@ module Telnyx
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PhoneNumbers::PhoneNumbersJob>]
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PhoneNumbers::NumbersPhoneNumbersJob>]
         #
         # @see Telnyx::Models::PhoneNumbers::JobListParams
         def list(params = {})
@@ -58,7 +58,7 @@ module Telnyx
             path: "phone_numbers/jobs",
             query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
             page: Telnyx::Internal::DefaultFlatPagination,
-            model: Telnyx::PhoneNumbers::PhoneNumbersJob,
+            model: Telnyx::PhoneNumbers::NumbersPhoneNumbersJob,
             options: options
           )
         end
@@ -108,7 +108,7 @@ module Telnyx
         #
         # @param connection_id [String] Body param: Identifies the connection associated with the phone number.
         #
-        # @param customer_reference [String] Body param: A customer reference string for customer look ups.
+        # @param customer_reference [String] Body param: Sets the customer reference on the selected phone numbers and retain
         #
         # @param deletion_lock_enabled [Boolean] Body param: Indicates whether to enable or disable the deletion lock on each pho
         #

data/lib/telnyx/resources/portouts.rb

@@ -43,7 +43,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::PortoutListParams} for more details.
       #
-      # Returns the portout requests according to filters
+      # Returns the portout requests according to filters. Carrier Port Out API
+      # available. Please contact porting@telnyx.com.
       #
       # @overload list(filter: nil, page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/spend_limits.rb

@@ -25,6 +25,13 @@ module Telnyx
     #   completions, Responses, Anthropic Messages and classification requests;
     #   requests already running finish normally. Take the list of products from the
     #   list operation.
+    # - **API key limits.** For `inference`, a limit can also apply to one API key,
+    #   named by `credential_id`: the key's identifier as recorded on usage, never its
+    #   secret. When the key's spend goes above its own limit, only that key is
+    #   blocked, with the error title `API key spend limit reached` (code `10039`);
+    #   the account's other keys keep working. The API key limits of a period cannot
+    #   add up to more than the total limit when the total has an amount. Only
+    #   language-model requests authenticated with an API key count toward its limit.
     # - **Limits set by Telnyx.** Telnyx support can also set a limit on your account.
     #   It is listed with `origin: operator` and you can update or delete it like your
     #   own.
@@ -33,7 +40,9 @@ module Telnyx
       # `amount` and `unlimited: true`. The period's spend is checked at once: if it is
       # already above the new limit, the product is blocked immediately
       # (`evaluation.blocked_now`). Returns 409 when a limit already exists for the
-      # product and period; update it instead.
+      # product and period; update it instead. With `credential_id`, the limit applies
+      # to that API key only: it needs an `amount`, and the period's API key limits
+      # cannot add up to more than the total limit when the total has an amount.
       #
       # @overload create(body:, request_options: {})
       #
@@ -63,13 +72,18 @@ module Telnyx
       # once: raising the limit above the spend lifts the period's block
       # (`evaluation.released`), and lowering it below the spend blocks the product
       # (`evaluation.blocked_now`). Returns 404 when no limit is set; create it instead.
+      # With the `credential_id` query parameter, the request changes that API key's
+      # limit; it needs an `amount`, and it can be at most the period's total limit.
+      # Lowering the total limit below the period's highest API key limit is refused.
       #
-      # @overload update(product, body:, period: nil, request_options: {})
+      # @overload update(product, body:, credential_id: nil, period: nil, request_options: {})
       #
       # @param product [String] Path param: Product the limit applies to, as returned in `product` by the list o
       #
       # @param body [Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitWithAmount, Telnyx::Models::SpendLimitUpdateParams::Body::UpdateSpendLimitUnlimited] Body param: Send exactly one of `amount` and `unlimited: true`.
       #
+      # @param credential_id [String] Query param: Identifier of one API key as recorded on usage, never the key's sec
+      #
       # @param period [Symbol, Telnyx::Models::SpendLimitPeriod] Query param: Limit period. Defaults to `daily`; send it explicitly.
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -94,7 +108,9 @@ module Telnyx
       # the spend so far in the period and whether the product is blocked. An entry
       # without a limit is still listed (`limit: null`). When the spend cannot be read,
       # the entry is returned with `spend_usd: null` and `spend_error` set. The list is
-      # not paginated.
+      # not paginated. Each entry also lists the API key limits of its product and
+      # period in `credential_limits`, with each key's spend and block. Each API key
+      # limit can be at most the total limit; together they may add up to more than it.
       #
       # @overload list(request_options: {})
       #
@@ -112,16 +128,25 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::SpendLimitDeleteParams} for more details.
+      #
       # Removes the limit for the product and period. For `inference`, which has no
       # default limit, the product becomes unlimited for the period and the period's
       # block is lifted (`evaluation.released`). The response carries `limit: null` and
       # the `effective_limit_usd` that applies after the removal. Returns 404 when no
-      # limit is set.
+      # limit is set. With the `credential_id` query parameter, the request removes that
+      # API key's limit for the period and lifts the key's block in that period at once.
+      # A block under the key's limit in the other period stays
+      # (`evaluation.still_blocked_other_period`). Removing the total limit leaves the
+      # API key limits in place.
       #
-      # @overload delete(product, period: nil, reason: nil, request_options: {})
+      # @overload delete(product, credential_id: nil, period: nil, reason: nil, request_options: {})
       #
       # @param product [String] Product the limit applies to, as returned in `product` by the list operation.
       #
+      # @param credential_id [String] Identifier of one API key as recorded on usage, never the key's secret, percent-
+      #
       # @param period [Symbol, Telnyx::Models::SpendLimitPeriod] Limit period. Defaults to `daily`; send it explicitly.
       #
       # @param reason [String] Why the limit is removed, kept for audit. At most 500 characters.

data/lib/telnyx/resources/tailscale_subnet_routers.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Tailscale Subnet Router operations
+    class TailscaleSubnetRouters
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::TailscaleSubnetRouterCreateParams} for more details.
+      #
+      # Creates a Tailscale Subnet Router on a Network and enrolls it in the user's
+      # tailnet with the auth key. The response returns the router with `status`
+      # `provisioning`. Poll `GET /tailscale_subnet_routers/{id}` until it is
+      # `provisioned`. Then approve its routes in the tailnet, unless an auto-approver
+      # covers them.
+      #
+      # @overload create(advertised_routes:, auth_key:, name:, network_id:, region_code:, request_options: {})
+      #
+      # @param advertised_routes [Array<String>] IPv4 subnets of the Network that the router advertises to the tailnet. Each entr
+      #
+      # @param auth_key [String] A Tailscale auth key that enrolls the router in the user's tailnet: reusable, pr
+      #
+      # @param name [String] A user specified name for the router.
+      #
+      # @param network_id [String] The id of the Network to attach the router to.
+      #
+      # @param region_code [String] The code of the region to create the router in. `GET /network_coverage` lists th
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::TailscaleSubnetRouterCreateResponse]
+      #
+      # @see Telnyx::Models::TailscaleSubnetRouterCreateParams
+      def create(params)
+        parsed, options = Telnyx::TailscaleSubnetRouterCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "tailscale_subnet_routers",
+          body: parsed,
+          model: Telnyx::Models::TailscaleSubnetRouterCreateResponse,
+          options: options
+        )
+      end
+
+      # Returns the details of a single Tailscale Subnet Router by its identifier,
+      # including its enrollment state.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] Identifies the resource.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::TailscaleSubnetRouterRetrieveResponse]
+      #
+      # @see Telnyx::Models::TailscaleSubnetRouterRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["tailscale_subnet_routers/%1$s", id],
+          model: Telnyx::Models::TailscaleSubnetRouterRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::TailscaleSubnetRouterUpdateParams} for more details.
+      #
+      # Renames the router, changes its advertised routes, or retries a failed
+      # enrollment. Any change queues a new provisioning run and returns the router with
+      # `status` `provisioning`. The router keeps its machine identity on the tailnet.
+      # Send an empty object to retry a `failed` router with its stored auth key.
+      # Include a new `auth_key` only while the router has never enrolled. The router's
+      # Network and region cannot change: create a new router instead.
+      #
+      # @overload update(id, advertised_routes: nil, auth_key: nil, name: nil, request_options: {})
+      #
+      # @param id [String] Identifies the resource.
+      #
+      # @param advertised_routes [Array<String>] IPv4 subnets of the Network that the router advertises to the tailnet. Each entr
+      #
+      # @param auth_key [String] A replacement Tailscale auth key. Accepted only while the router has never enrol
+      #
+      # @param name [String] A user specified name for the router.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::TailscaleSubnetRouterUpdateResponse]
+      #
+      # @see Telnyx::Models::TailscaleSubnetRouterUpdateParams
+      def update(id, params = {})
+        parsed, options = Telnyx::TailscaleSubnetRouterUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["tailscale_subnet_routers/%1$s", id],
+          body: parsed,
+          model: Telnyx::Models::TailscaleSubnetRouterUpdateResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::TailscaleSubnetRouterListParams} for more details.
+      #
+      # Returns a paginated list of the Tailscale Subnet Routers on the account, with
+      # support for filtering by Network.
+      #
+      # @overload list(filter: nil, page_number: nil, page_size: nil, request_options: {})
+      #
+      # @param filter [Telnyx::Models::TailscaleSubnetRouterListParams::Filter] Consolidated filter parameter (deepObject style). Originally: filter[network_id]
+      #
+      # @param page_number [Integer]
+      #
+      # @param page_size [Integer]
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::TailscaleSubnetRouter>]
+      #
+      # @see Telnyx::Models::TailscaleSubnetRouterListParams
+      def list(params = {})
+        parsed, options = Telnyx::TailscaleSubnetRouterListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "tailscale_subnet_routers",
+          query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
+          model: Telnyx::TailscaleSubnetRouter,
+          options: options
+        )
+      end
+
+      # Removes the router from the Network and logs it out of the tailnet. The response
+      # returns the router with `status` `deleting`. The record disappears once removal
+      # completes. A machine entry can remain in the tailnet's admin console until it is
+      # removed there.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] Identifies the resource.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::TailscaleSubnetRouterDeleteResponse]
+      #
+      # @see Telnyx::Models::TailscaleSubnetRouterDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["tailscale_subnet_routers/%1$s", id],
+          model: Telnyx::Models::TailscaleSubnetRouterDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/telnyx/resources/telephony_credentials.rb

@@ -135,24 +135,30 @@ module Telnyx
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::TelephonyCredentialCreateTokenParams} for more details.
+      #
       # Create an Access Token (JWT) for the credential.
       #
-      # @overload create_token(id, request_options: {})
+      # @overload create_token(id, idempotency_key: nil, request_options: {})
       #
       # @param id [String] Identifies the resource.
       #
+      # @param idempotency_key [String] Unique key for safely retrying the same logical request. Generate a UUID v4 for
+      #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [String]
       #
       # @see Telnyx::Models::TelephonyCredentialCreateTokenParams
       def create_token(id, params = {})
+        parsed, options = Telnyx::TelephonyCredentialCreateTokenParams.dump_request(params)
         @client.request(
           method: :post,
           path: ["telephony_credentials/%1$s/token", id],
-          headers: {"accept" => "text/plain"},
+          headers: {"accept" => "text/plain", **parsed}.transform_keys(idempotency_key: "idempotency-key"),
           model: String,
-          options: params[:request_options]
+          options: options
         )
       end
 

data/lib/telnyx/resources/texml/accounts/calls/recordings.rb

@@ -7,13 +7,17 @@ module Telnyx
         class Calls
           # TeXML REST Commands
           class Recordings
+            # Some parameter documentations has been truncated, see
+            # {Telnyx::Models::Texml::Accounts::Calls::RecordingRecordingSidJsonParams} for
+            # more details.
+            #
             # Updates recording resource for particular call.
             #
             # @overload recording_sid_json(recording_sid, account_sid:, call_sid:, status: nil, request_options: {})
             #
             # @param recording_sid [String] Path param: Uniquely identifies the recording by id.
             #
-            # @param account_sid [String] Path param: The id of the account the resource belongs to.
+            # @param account_sid [String] Path param: The UUID of the Telnyx account that owns the resource, for example `
             #
             # @param call_sid [String] Path param: The CallSid that identifies the call to update.
             #

data/lib/telnyx/resources/texml/accounts/calls/recordings_json.rb

@@ -17,7 +17,7 @@ module Telnyx
             #
             # @param call_sid [String] Path param: The CallSid that identifies the call to update.
             #
-            # @param account_sid [String] Path param: The id of the account the resource belongs to.
+            # @param account_sid [String] Path param: The UUID of the Telnyx account that owns the resource, for example `
             #
             # @param play_beep [Boolean] Body param: Whether to play a beep when recording is started.
             #
@@ -54,13 +54,17 @@ module Telnyx
               )
             end
 
+            # Some parameter documentations has been truncated, see
+            # {Telnyx::Models::Texml::Accounts::Calls::RecordingsJsonRetrieveRecordingsJsonParams}
+            # for more details.
+            #
             # Returns recordings for a call identified by call_sid.
             #
             # @overload retrieve_recordings_json(call_sid, account_sid:, request_options: {})
             #
             # @param call_sid [String] The CallSid that identifies the call to update.
             #
-            # @param account_sid [String] The id of the account the resource belongs to.
+            # @param account_sid [String] The UUID of the Telnyx account that owns the resource, for example `f5586561-8ff
             #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #

data/lib/telnyx/resources/texml/accounts/calls/siprec.rb

@@ -17,7 +17,7 @@ module Telnyx
             #
             # @param siprec_sid [String] Path param: The SiprecSid that uniquely identifies the Sip Recording.
             #
-            # @param account_sid [String] Path param: The id of the account the resource belongs to.
+            # @param account_sid [String] Path param: The UUID of the Telnyx account that owns the resource, for example `
             #
             # @param call_sid [String] Path param: The CallSid that identifies the call to update.
             #

data/lib/telnyx/resources/texml/accounts/calls/streams.rb

@@ -7,13 +7,17 @@ module Telnyx
         class Calls
           # TeXML REST Commands
           class Streams
+            # Some parameter documentations has been truncated, see
+            # {Telnyx::Models::Texml::Accounts::Calls::StreamStreamingSidJsonParams} for more
+            # details.
+            #
             # Updates streaming resource for particular call.
             #
             # @overload streaming_sid_json(streaming_sid, account_sid:, call_sid:, status: nil, request_options: {})
             #
             # @param streaming_sid [String] Path param: Uniquely identifies the streaming by id.
             #
-            # @param account_sid [String] Path param: The id of the account the resource belongs to.
+            # @param account_sid [String] Path param: The UUID of the Telnyx account that owns the resource, for example `
             #
             # @param call_sid [String] Path param: The CallSid that identifies the call to update.
             #