late-sdk 0.0.725 → 0.0.727

data/lib/zernio-sdk/models/send_inbox_message200_response_data_attachments_inner.rb

@@ -0,0 +1,156 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class SendInboxMessage200ResponseDataAttachmentsInner < ApiModelBase
+    attr_accessor :type
+
+    attr_accessor :url
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'type' => :'type',
+        :'url' => :'url'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'type' => :'String',
+        :'url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SendInboxMessage200ResponseDataAttachmentsInner` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SendInboxMessage200ResponseDataAttachmentsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'type')
+        self.type = attributes[:'type']
+      end
+
+      if attributes.key?(:'url')
+        self.url = attributes[:'url']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          type == o.type &&
+          url == o.url
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [type, url].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.725'
+  VERSION = '0.0.727'
 end

data/lib/zernio-sdk.rb

@@ -86,6 +86,8 @@ require 'zernio-sdk/models/archive_lead_form200_response'
 require 'zernio-sdk/models/assign_google_business_location200_response'
 require 'zernio-sdk/models/assign_google_business_location200_response_account'
 require 'zernio-sdk/models/assign_google_business_location_request'
+require 'zernio-sdk/models/attach_number_to_sip_trunk200_response'
+require 'zernio-sdk/models/attach_number_to_sip_trunk_request'
 require 'zernio-sdk/models/batch_get_google_business_reviews200_response'
 require 'zernio-sdk/models/batch_get_google_business_reviews200_response_location_reviews_inner'
 require 'zernio-sdk/models/batch_get_google_business_reviews_request'
@@ -287,6 +289,9 @@ require 'zernio-sdk/models/create_sequence_request'
 require 'zernio-sdk/models/create_sequence_request_steps_inner'
 require 'zernio-sdk/models/create_sequence_request_steps_inner_template'
 require 'zernio-sdk/models/create_sequence_request_steps_inner_template_variable_mapping_value'
+require 'zernio-sdk/models/create_sip_trunk201_response'
+require 'zernio-sdk/models/create_sip_trunk201_response_termination'
+require 'zernio-sdk/models/create_sip_trunk_request'
 require 'zernio-sdk/models/create_sms_sender_id200_response'
 require 'zernio-sdk/models/create_sms_sender_id_request'
 require 'zernio-sdk/models/create_standalone_ad200_response'
@@ -374,6 +379,7 @@ require 'zernio-sdk/models/delete_inbox_review_reply_request'
 require 'zernio-sdk/models/delete_sms_sender_id200_response'
 require 'zernio-sdk/models/delete_value_rule_set200_response'
 require 'zernio-sdk/models/delete_whatsapp_business_username_request'
+require 'zernio-sdk/models/detach_number_from_sip_trunk200_response'
 require 'zernio-sdk/models/dial_voice_web_call200_response'
 require 'zernio-sdk/models/dial_voice_web_call_request'
 require 'zernio-sdk/models/disable_sms_on_number200_response'
@@ -697,6 +703,8 @@ require 'zernio-sdk/models/get_sequence200_response'
 require 'zernio-sdk/models/get_sequence200_response_sequence'
 require 'zernio-sdk/models/get_sequence200_response_sequence_steps_inner'
 require 'zernio-sdk/models/get_sequence200_response_sequence_steps_inner_template'
+require 'zernio-sdk/models/get_sip_trunk200_response'
+require 'zernio-sdk/models/get_sip_trunk200_response_numbers_inner'
 require 'zernio-sdk/models/get_slack_settings200_response'
 require 'zernio-sdk/models/get_slack_settings200_response_account'
 require 'zernio-sdk/models/get_sms_registration200_response'
@@ -986,6 +994,9 @@ require 'zernio-sdk/models/list_sequence_enrollments200_response'
 require 'zernio-sdk/models/list_sequence_enrollments200_response_enrollments_inner'
 require 'zernio-sdk/models/list_sequences200_response'
 require 'zernio-sdk/models/list_sequences200_response_sequences_inner'
+require 'zernio-sdk/models/list_sip_trunks200_response'
+require 'zernio-sdk/models/list_sip_trunks200_response_trunks_inner'
+require 'zernio-sdk/models/list_sip_trunks200_response_trunks_inner_termination'
 require 'zernio-sdk/models/list_slack_members200_response'
 require 'zernio-sdk/models/list_slack_members200_response_members_inner'
 require 'zernio-sdk/models/list_sms_opt_outs200_response'
@@ -1174,6 +1185,7 @@ require 'zernio-sdk/models/review_webhook_review_reply'
 require 'zernio-sdk/models/review_webhook_review_reviewer'
 require 'zernio-sdk/models/revoke_connected_app200_response'
 require 'zernio-sdk/models/rf_prediction'
+require 'zernio-sdk/models/rotate_sip_trunk_credentials200_response'
 require 'zernio-sdk/models/saved_targeting_audience'
 require 'zernio-sdk/models/schedule_broadcast200_response'
 require 'zernio-sdk/models/schedule_broadcast200_response_broadcast'
@@ -1237,6 +1249,7 @@ require 'zernio-sdk/models/send_discord_direct_message_request'
 require 'zernio-sdk/models/send_discord_direct_message_request_attachments_inner'
 require 'zernio-sdk/models/send_inbox_message200_response'
 require 'zernio-sdk/models/send_inbox_message200_response_data'
+require 'zernio-sdk/models/send_inbox_message200_response_data_attachments_inner'
 require 'zernio-sdk/models/send_inbox_message400_response'
 require 'zernio-sdk/models/send_inbox_message400_response_platform_error'
 require 'zernio-sdk/models/send_inbox_message_request'

data/openapi.yaml

@@ -25894,6 +25894,17 @@ paths:
         instead of sending the message a second time; same key + different body
         returns 422; a key still in flight returns 409. Works for JSON and
         multipart (file upload) requests alike. Keys are retained for 24 hours.
+
+        Only successful (2xx) responses are stored for replay: if the request
+        throws or returns a non-2xx status, the key is released so the same key
+        can be retried once the problem is fixed. The header therefore protects
+        the "request succeeded but the response was lost" case. For an ambiguous
+        failure (a 5xx or a network timeout), reconcile before retrying: a
+        failure after the platform already accepted the message also releases
+        the key, and a blind retry could send it twice. List the conversation's
+        messages first, and treat an empty result as inconclusive rather than
+        as proof nothing was sent, since a send that failed while being recorded
+        leaves no trace on our side.
       tags: [Messages]
       security: [{ bearerAuth: [] }]
       parameters:
@@ -26434,10 +26445,20 @@ paths:
                   data:
                     type: object
                     properties:
-                      messageId: { type: string, description: ID of the sent message (not returned for Reddit) }
-                      conversationId: { type: [string, "null"], description: Twitter conversation ID }
-                      sentAt: { type: [string, "null"], format: date-time, description: Bluesky sent timestamp }
-                      message: { type: [string, "null"], description: Success message (Reddit only) }
+                      messageId:
+                        type: string
+                        description: 'Platform id of the sent message (not returned for Reddit). For WhatsApp this is the raw Meta wamid, the same id delivered as message.platformMessageId on webhooks and delivery-status updates, and the value to pass as replyTo to quote-reply.'
+                      conversationId:
+                        type: string
+                        description: 'Zernio conversation id, echoed so the thread can be read back or replied to. It equals the id the list-conversations endpoint returns for Telegram, WhatsApp, SMS and Slack; for Facebook, Instagram, Bluesky and Reddit that endpoint returns the platform thread id instead, so do not correlate the two by equality. For X (Twitter), when the request addressed the conversation by its Twitter dm_conversation_id, that platform id is echoed back instead. Omitted when the send succeeded but the conversation could not be resolved to a stored record.'
+                      attachments:
+                        type: array
+                        description: 'Echo of the sent attachment with its resolved public URL, when one is available (Facebook, Instagram, Telegram, WhatsApp).'
+                        items:
+                          type: object
+                          properties:
+                            type: { type: string }
+                            url: { type: string }
         '400':
           description: 'Bad request (e.g., attachment not supported for platform, validation error, category combined with a template or attachment, category used on a non-WhatsApp account, or the WhatsApp Business Account is not eligible for Direct Send)'
           content:
@@ -31917,6 +31938,7 @@ paths:
                         telnyxOrderId: { type: [string, "null"], description: Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. }
                         monthlyCents: { type: integer, description: Per-country monthly price in cents ($2..$25). }
                         hostedByZernio: { type: boolean, description: "False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them." }
+                        sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
                         profileId: { type: object }
                         provisionedAt: { type: string, format: date-time }
                         metaPreverifiedId: { type: string }
@@ -32007,6 +32029,7 @@ paths:
                       endUserLastName: { type: [string, "null"] }
                       regulatoryDeclineReason: { type: [string, "null"], description: Reviewer rejection reason when status is regulatory_declined. }
                       provisionedAt: { type: string, format: date-time }
+                      sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
     delete:
@@ -32048,6 +32071,7 @@ paths:
         '400': { description: Phone number is already released or being released }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
+        '409': { description: 'The number is attached to a SIP trunk; detach it first (code invalid_resource_state).' }
 
   /v1/phone-numbers/purchase:
     post:
@@ -32458,6 +32482,7 @@ paths:
                         telnyxOrderId: { type: [string, "null"], description: Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. }
                         monthlyCents: { type: integer, description: Per-country monthly price in cents ($2..$25). }
                         hostedByZernio: { type: boolean, description: "False for numbers you brought yourself (connected via Meta embedded signup) — they live on your own carrier, so SMS/Calls can't be enabled on them." }
+                        sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
                         profileId: { type: object }
                         provisionedAt: { type: string, format: date-time }
                         metaPreverifiedId: { type: string }
@@ -34355,6 +34380,7 @@ paths:
                   ivrOptions: { type: array, items: { type: object, properties: { digit: { type: string }, forwardTo: { type: string }, label: { type: string } } } }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Number not found }
+        '409': { description: 'This number is attached to a SIP trunk; detach it first (code invalid_resource_state).' }
         '422': { description: "This number is hosted by your own carrier (brought via WhatsApp embedded signup), so calls can't be enabled on it." }
     delete:
       x-resource-group: "telephony"
@@ -34381,6 +34407,266 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Number not found }
 
+  /v1/phone-numbers/sip-trunks:
+    post:
+      x-resource-group: "telephony"
+      operationId: createSipTrunk
+      tags: [Voice]
+      summary: Create a SIP trunk
+      description: |
+        Creates a SIP trunk an external voice platform (Retell, ElevenLabs,
+        Vapi, or any SIP endpoint) can import your Zernio numbers into. The
+        trunk carries both directions: inbound calls on attached numbers are
+        delivered to `sipHost`, and the platform originates outbound calls
+        through `termination.uri` with the digest credentials.
+
+        The `digestPassword` is returned only by this call (and by
+        rotate-credentials); store it immediately. Attach any number of numbers
+        to a trunk. Several trunks may point at the same host — each carries its
+        own credentials and spend cap, so separate destination workspaces (e.g.
+        an agency's clients) stay isolated.
+
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [label, sipHost]
+              properties:
+                label: { type: string, maxLength: 80, description: Display name for the trunk. }
+                sipHost: { type: string, description: 'Fully-qualified hostname inbound calls are delivered to (e.g. sip.rtc.elevenlabs.io, sip.retellai.com).' }
+                sipPort: { type: integer, minimum: 1, maximum: 65535, description: 'Defaults to 5061 for tls, 5060 otherwise.' }
+                transport: { type: string, enum: [tls, tcp, udp], description: 'Signaling transport toward sipHost. Default tls (with SRTP media).' }
+      responses:
+        '201':
+          description: Trunk created. The digest password is shown only here and on rotate.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id: { type: string }
+                  label: { type: string }
+                  sipHost: { type: string }
+                  sipPort: { type: integer }
+                  transport: { type: string, enum: [tls, tcp, udp] }
+                  termination:
+                    type: object
+                    properties:
+                      uri: { type: string, description: 'Telnyx termination host the platform dials for outbound (sip.telnyx.com).' }
+                      username: { type: string, description: SIP digest username. }
+                  numbersAttached: { type: integer }
+                  createdAt: { type: [string, "null"], format: date-time }
+                  digestPassword: { type: string, description: 'SIP digest password, shown only in this response.' }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403': { description: 'SIP trunking is not enabled for this workspace, or the workspace is on legacy (non-usage-based) billing, which cannot invoice trunk call costs (code feature_not_available).' }
+        '409': { description: 'The workspace trunk limit was reached (code invalid_resource_state).' }
+        '422': { description: 'The host cannot be used as a trunk destination (e.g. a Zernio or carrier host).' }
+    get:
+      x-resource-group: "telephony"
+      operationId: listSipTrunks
+      tags: [Voice]
+      summary: List SIP trunks
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: The workspace's trunks. Passwords are never included.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  trunks:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string }
+                        label: { type: string }
+                        sipHost: { type: string }
+                        sipPort: { type: integer }
+                        transport: { type: string, enum: [tls, tcp, udp] }
+                        termination:
+                          type: object
+                          properties:
+                            uri: { type: string }
+                            username: { type: string }
+                        numbersAttached: { type: integer }
+                        createdAt: { type: [string, "null"], format: date-time }
+                  enabled: { type: boolean, description: 'Whether this workspace can create SIP trunks. Managing existing trunks always works.' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+
+  /v1/phone-numbers/sip-trunks/{id}:
+    get:
+      x-resource-group: "telephony"
+      operationId: getSipTrunk
+      tags: [Voice]
+      summary: Get a SIP trunk
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string } }
+      responses:
+        '200':
+          description: Trunk detail, including the attached numbers.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id: { type: string }
+                  label: { type: string }
+                  sipHost: { type: string }
+                  sipPort: { type: integer }
+                  transport: { type: string, enum: [tls, tcp, udp] }
+                  termination:
+                    type: object
+                    properties:
+                      uri: { type: string }
+                      username: { type: string }
+                  numbersAttached: { type: integer }
+                  createdAt: { type: [string, "null"], format: date-time }
+                  numbers:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string, description: 'Phone number record ID.' }
+                        phoneNumber: { type: string }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: SIP trunk not found }
+    delete:
+      x-resource-group: "telephony"
+      operationId: deleteSipTrunk
+      tags: [Voice]
+      summary: Delete a SIP trunk
+      description: |
+        Tears down the trunk and its carrier-side objects. Refused while any
+        number is still attached: detach them first.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string } }
+      responses:
+        '200':
+          description: Trunk deleted.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  deleted: { type: boolean }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: SIP trunk not found }
+        '409': { description: 'Numbers are still attached to this trunk (code invalid_resource_state).' }
+
+  /v1/phone-numbers/sip-trunks/{id}/rotate-credentials:
+    post:
+      x-resource-group: "telephony"
+      operationId: rotateSipTrunkCredentials
+      tags: [Voice]
+      summary: Rotate a SIP trunk's password
+      description: |
+        Mints a new digest password on the trunk. The old password stops
+        working immediately, so update the destination platform right away.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string } }
+      responses:
+        '200':
+          description: New credentials. The password is shown only here.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  termination:
+                    type: object
+                    properties:
+                      uri: { type: string, description: 'Telnyx termination host the platform dials for outbound (sip.telnyx.com).' }
+                      username: { type: string, description: SIP digest username. }
+                  digestPassword: { type: string }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: SIP trunk not found }
+
+  /v1/phone-numbers/{id}/sip-trunk:
+    post:
+      x-resource-group: "telephony"
+      operationId: attachNumberToSipTrunk
+      tags: [Voice]
+      summary: Attach a number to a SIP trunk
+      description: |
+        Routes the number's calls to the trunk: the external platform receives
+        its inbound directly and can present it as outbound caller ID. While
+        attached, Zernio-side voice features are off for this number (call
+        forwarding, IVR, voicemail, recording, the softphone, and WhatsApp
+        calling), so the number must have Calls and WhatsApp calling disabled
+        before attaching. SMS and WhatsApp messaging are unaffected.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string }, description: "Phone number record ID (from GET /v1/phone-numbers)." }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [trunkId]
+              properties:
+                trunkId: { type: string, description: 'SIP trunk ID (from POST /v1/phone-numbers/sip-trunks).' }
+      responses:
+        '200':
+          description: Number attached (idempotent for the same trunk).
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  attached: { type: boolean }
+                  phoneNumber: { type: string }
+                  trunkId: { type: string }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403': { description: 'SIP trunking is not enabled for this workspace, or the workspace is on legacy (non-usage-based) billing, which cannot invoice trunk call costs (code feature_not_available).' }
+        '404': { description: Number or trunk not found }
+        '409': { description: 'The number still has Calls or WhatsApp calling enabled, is mid WhatsApp verification, is not active, or is attached to another trunk (code invalid_resource_state).' }
+        '422': { description: 'This number is hosted by your own carrier (brought via WhatsApp embedded signup), so it cannot be trunked.' }
+    delete:
+      x-resource-group: "telephony"
+      operationId: detachNumberFromSipTrunk
+      tags: [Voice]
+      summary: Detach a number from its SIP trunk
+      description: |
+        Returns the number's calls to Zernio routing. Idempotent when the
+        number is not attached to any trunk.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string } }
+      responses:
+        '200':
+          description: Number detached.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  attached: { type: boolean, description: Always false after a successful detach. }
+                  phoneNumber: { type: string }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Number not found }
+
   /v1/phone-numbers/{id}/sms:
     post:
       x-resource-group: "telephony"
@@ -34594,6 +34880,7 @@ paths:
         '400': { description: 'Invalid request (including forwardTo set to the number itself)' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Phone number not found }
+        '409': { description: 'This number is attached to a SIP trunk; detach it first (code invalid_resource_state).' }
         '422': { description: "Not eligible to enable calling: not on usage-based billing, or the number's messaging limit is below Meta's ~2,000-daily-recipient threshold (TIER_250). Warm the number up to raise the limit." }
     patch:
       x-resource-group: "telephony"
@@ -34781,6 +35068,7 @@ paths:
                       endUserLastName: { type: [string, "null"] }
                       regulatoryDeclineReason: { type: [string, "null"], description: Reviewer rejection reason when status is regulatory_declined. }
                       provisionedAt: { type: string, format: date-time }
+                      sipTrunkId: { type: [string, "null"], description: 'SIP trunk the number is attached to; null when not trunked. While attached, enabling Calls or WhatsApp calling, requesting WhatsApp verification, and releasing the number all return 409.' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
     delete:
@@ -34826,6 +35114,7 @@ paths:
         '400': { description: Phone number is already released or being released }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
+        '409': { description: 'The number is attached to a SIP trunk; detach it first (code invalid_resource_state).' }
 
   # ─── WhatsApp Sandbox (shared test number) ──────────────────────
   #

data/spec/api/messages_api_spec.rb

@@ -196,7 +196,7 @@ describe 'MessagesApi' do
 
   # unit tests for send_inbox_message
   # Send message
-  # Send a message in a conversation. Supports text, attachments, quick replies, buttons, templates, and message tags. Attachment and interactive message support varies by platform.  WhatsApp template messages: to send an approved template into this conversation (required when the 24-hour customer-service window is closed), use the `template` field with a single element carrying the template reference: `{ \"elements\": [{ \"name\": ..., \"language\": ..., \"components\": [...] }] }`. See the `template` field below for the exact shape. To send a template to a phone number you have no conversation with yet, use the create-conversation endpoint (POST /v1/inbox/conversations) instead.  WhatsApp rich interactive messages (list, CTA URL, Flow, location request) are available via the `interactive` field. Tap events are delivered through the `message.received` webhook with WhatsApp-specific `metadata` fields (`interactiveType`, `interactiveId`, `flowResponseJson`, `flowResponseData`).  **Idempotency:** send an `Idempotency-Key` header to make retries safe (e.g. after a client-side timeout where delivery is unknown): same key + same body replays the original response (with `Idempotent-Replayed: true`) instead of sending the message a second time; same key + different body returns 422; a key still in flight returns 409. Works for JSON and multipart (file upload) requests alike. Keys are retained for 24 hours. 
+  # Send a message in a conversation. Supports text, attachments, quick replies, buttons, templates, and message tags. Attachment and interactive message support varies by platform.  WhatsApp template messages: to send an approved template into this conversation (required when the 24-hour customer-service window is closed), use the `template` field with a single element carrying the template reference: `{ \"elements\": [{ \"name\": ..., \"language\": ..., \"components\": [...] }] }`. See the `template` field below for the exact shape. To send a template to a phone number you have no conversation with yet, use the create-conversation endpoint (POST /v1/inbox/conversations) instead.  WhatsApp rich interactive messages (list, CTA URL, Flow, location request) are available via the `interactive` field. Tap events are delivered through the `message.received` webhook with WhatsApp-specific `metadata` fields (`interactiveType`, `interactiveId`, `flowResponseJson`, `flowResponseData`).  **Idempotency:** send an `Idempotency-Key` header to make retries safe (e.g. after a client-side timeout where delivery is unknown): same key + same body replays the original response (with `Idempotent-Replayed: true`) instead of sending the message a second time; same key + different body returns 422; a key still in flight returns 409. Works for JSON and multipart (file upload) requests alike. Keys are retained for 24 hours.  Only successful (2xx) responses are stored for replay: if the request throws or returns a non-2xx status, the key is released so the same key can be retried once the problem is fixed. The header therefore protects the \"request succeeded but the response was lost\" case. For an ambiguous failure (a 5xx or a network timeout), reconcile before retrying: a failure after the platform already accepted the message also releases the key, and a blind retry could send it twice. List the conversation's messages first, and treat an empty result as inconclusive rather than as proof nothing was sent, since a send that failed while being recorded leaves no trace on our side. 
   # @param conversation_id Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
   # @param send_inbox_message_request 
   # @param [Hash] opts the optional parameters