zernio-sdk 0.0.830 → 0.0.832

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7fd0b371a0accafb9fdeea270ee98d73329d3351a4ebbd84bb4a948889b414f
-  data.tar.gz: aac25418ea74a172b42d62d6ec291e8d784dcbded3a90d055d17f812eff35d7d
+  metadata.gz: 61f77fdd54e926a7230ea74ace3606ebb4d0d9a46d1a76a0fabb1c3079a73579
+  data.tar.gz: b1a1985fc31ab357de075c7a1f77c81d38be1e8c6a02d3d3e514fea11164bbde
 SHA512:
-  metadata.gz: 58b7fc738fd83a161b2993a7159d170b67ad4ccdeacfafc68880ab009f6f6961f63b44cfe42790cd8359584c080d5ed73327b48d983a4c41da083e6a9152364d
-  data.tar.gz: e3385b8b195c68a653729ef0de1bbcea618910a55e0f630263760ded658dbfb2e699861da6924d26c166db099bf0df409e0d0910434b4c99a9b46e12aaaee6ef
+  metadata.gz: 388f00ec6f368ebacb57e09663e0c74b1327cd08e47bca54501530fff1efad3764550ff0b781d82e1ac20567f35ec42fe9ab404a30f2625ac5a1879da8f35e85
+  data.tar.gz: 478580308ff1116844c228018be43cd19a6bc7ce67f7555f5b815be3ca47998d937ec66825a970ac3e03e139d6e3ff2bc41c9d1904a4fea7cbf3f412c1e8853d

data/docs/ListPhoneNumberCountries200ResponseCountriesInner.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **code** | **String** | ISO 3166-1 alpha-2 | [optional] |
 | **tier** | **Integer** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3. | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
 | **calls_available** | **Boolean** | Regular phone (PSTN) calling on the number, inbound + outbound. Available on every offerable country. | [optional] |
 | **whatsapp_available** | **Boolean** | WhatsApp can be enabled on numbers from this country. | [optional] |

data/docs/ListPhoneNumberCountries200ResponseCountriesInnerTypesInner.md

@@ -7,7 +7,7 @@
 | **number_type** | **String** |  | [optional] |
 | **tier** | **Integer** |  | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number of this type costs per month, in cents. | [optional] |
 | **whatsapp_available** | **Boolean** | Always false for toll_free (WhatsApp does not reliably register toll-free numbers). | [optional] |
 | **sms_available** | **Boolean** |  | [optional] |
 | **calls_available** | **Boolean** |  | [optional] |

data/docs/ListPhoneNumbers200ResponseNumbersInner.md

@@ -10,7 +10,7 @@
 | **status** | **String** |  | [optional] |
 | **registrant_name** | **String** | For regulated numbers, who it's registered for (company or person) — set from the submitted KYC. | [optional] |
 | **telnyx_order_id** | **String** | Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review. | [optional] |
-| **monthly_cents** | **Integer** | Per-country monthly price in cents ($2..$25). | [optional] |
+| **monthly_cents** | **Integer** | What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes. | [optional] |
 | **hosted_by_zernio** | **Boolean** | 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. | [optional] |
 | **sip_trunk_id** | **String** | 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. | [optional] |
 | **profile_id** | **Object** |  | [optional] |

data/docs/ListWhatsAppNumberCountries200ResponseCountriesInner.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **code** | **String** | ISO 3166-1 alpha-2 | [optional] |
 | **tier** | **Integer** |  | [optional] |
-| **monthly_cents** | **Integer** |  | [optional] |
+| **monthly_cents** | **Integer** | Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3. | [optional] |
 | **needs_kyc** | **Boolean** |  | [optional] |
 | **outbound_calling_available** | **Boolean** |  | [optional] |
 

data/docs/MessagesApi.md

@@ -329,7 +329,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagesApi.new
-conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+conversation_id = 'conversation_id_example' # String | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
 account_id = 'account_id_example' # String | The social account ID
 
 begin
@@ -363,7 +363,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **conversation_id** | **String** | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed. |  |
 | **account_id** | **String** | The social account ID |  |
 
 ### Return type
@@ -400,7 +400,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagesApi.new
-conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+conversation_id = 'conversation_id_example' # String | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
 account_id = 'account_id_example' # String | Social account ID
 opts = {
   limit: 56, # Integer | Number of messages to return per page. Default 100, max 100.
@@ -439,7 +439,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **conversation_id** | **String** | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed. |  |
 | **account_id** | **String** | Social account ID |  |
 | **limit** | **Integer** | Number of messages to return per page. Default 100, max 100. | [optional][default to 100] |
 | **cursor** | **String** | Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response verbatim: a cursor we cannot parse returns 400 rather than silently restarting from the first page. | [optional] |
@@ -1014,7 +1014,7 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::MessagesApi.new
-conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+conversation_id = 'conversation_id_example' # String | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
 update_inbox_conversation_request = Zernio::UpdateInboxConversationRequest.new({account_id: 'account_id_example', status: 'active'}) # UpdateInboxConversationRequest | 
 
 begin
@@ -1048,7 +1048,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **conversation_id** | **String** | Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed. |  |
 | **update_inbox_conversation_request** | [**UpdateInboxConversationRequest**](UpdateInboxConversationRequest.md) |  |  |
 
 ### Return type

data/docs/PhoneNumbersApi.md

@@ -1149,7 +1149,7 @@ end
 
 Purchase phone number
 
-Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 

data/docs/WhatsAppPhoneNumbersApi.md

@@ -660,7 +660,7 @@ end
 
 Purchase phone number
 
-Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 

data/lib/zernio-sdk/api/messages_api.rb

@@ -325,7 +325,7 @@ module Zernio
 
     # Get conversation
     # Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param account_id [String] The social account ID
     # @param [Hash] opts the optional parameters
     # @return [GetInboxConversation200Response]
@@ -336,7 +336,7 @@ module Zernio
 
     # Get conversation
     # Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param account_id [String] The social account ID
     # @param [Hash] opts the optional parameters
     # @return [Array<(GetInboxConversation200Response, Integer, Hash)>] GetInboxConversation200Response data, response status code and response headers
@@ -395,7 +395,7 @@ module Zernio
 
     # List messages
     # Fetch messages for a specific conversation, with cursor-based pagination and ordering control.  Pagination: pass `pagination.nextCursor` from a prior response back as the `cursor` query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side.  Sort order: defaults to `asc` (oldest first, chat style). For the \"show me the latest messages\" pattern, pass `?sortOrder=desc&limit=N`. Twitter, Instagram, Telegram, WhatsApp and Reddit honor the requested order from the local message store. For Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field `sortOrderApplied` tells you what was actually applied.  Reddit threads are paginated client-side because Reddit's API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit's inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation.  Instagram and Facebook conversations include history from before the account was connected, replayed from Meta. That replay covers the 500 most recent messages per conversation: a longer thread keeps its newest 500 and older messages are not retrievable. Messages that arrived after the account was connected are unaffected. Replayed messages are stored as already read and emit no webhooks.  Twitter/X limitation: X's encrypted \"X Chat\" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.  This endpoint is read-only and does NOT mark messages as read or send read receipts. To mark a conversation read (and send WhatsApp blue ticks on eligible accounts), call `POST /v1/inbox/conversations/{conversationId}/read`. 
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param account_id [String] Social account ID
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :limit Number of messages to return per page. Default 100, max 100. (default to 100)
@@ -409,7 +409,7 @@ module Zernio
 
     # List messages
     # Fetch messages for a specific conversation, with cursor-based pagination and ordering control.  Pagination: pass &#x60;pagination.nextCursor&#x60; from a prior response back as the &#x60;cursor&#x60; query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side.  Sort order: defaults to &#x60;asc&#x60; (oldest first, chat style). For the \&quot;show me the latest messages\&quot; pattern, pass &#x60;?sortOrder&#x3D;desc&amp;limit&#x3D;N&#x60;. Twitter, Instagram, Telegram, WhatsApp and Reddit honor the requested order from the local message store. For Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field &#x60;sortOrderApplied&#x60; tells you what was actually applied.  Reddit threads are paginated client-side because Reddit&#39;s API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit&#39;s inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation.  Instagram and Facebook conversations include history from before the account was connected, replayed from Meta. That replay covers the 500 most recent messages per conversation: a longer thread keeps its newest 500 and older messages are not retrievable. Messages that arrived after the account was connected are unaffected. Replayed messages are stored as already read and emit no webhooks.  Twitter/X limitation: X&#39;s encrypted \&quot;X Chat\&quot; messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.  This endpoint is read-only and does NOT mark messages as read or send read receipts. To mark a conversation read (and send WhatsApp blue ticks on eligible accounts), call &#x60;POST /v1/inbox/conversations/{conversationId}/read&#x60;. 
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param account_id [String] Social account ID
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :limit Number of messages to return per page. Default 100, max 100. (default to 100)
@@ -1088,7 +1088,7 @@ module Zernio
 
     # Update conversation status
     # Archive or activate a conversation. Requires accountId in request body.
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param update_inbox_conversation_request [UpdateInboxConversationRequest] 
     # @param [Hash] opts the optional parameters
     # @return [UpdateInboxConversation200Response]
@@ -1099,7 +1099,7 @@ module Zernio
 
     # Update conversation status
     # Archive or activate a conversation. Requires accountId in request body.
-    # @param conversation_id [String] The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+    # @param conversation_id [String] Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.
     # @param update_inbox_conversation_request [UpdateInboxConversationRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(UpdateInboxConversation200Response, Integer, Hash)>] UpdateInboxConversation200Response data, response status code and response headers

data/lib/zernio-sdk/api/phone_numbers_api.rb

@@ -1065,7 +1065,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchasePhoneNumber200Response]
@@ -1075,7 +1075,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchasePhoneNumber200Response, Integer, Hash)>] PurchasePhoneNumber200Response data, response status code and response headers

data/lib/zernio-sdk/api/whats_app_phone_numbers_api.rb

@@ -621,7 +621,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchaseWhatsAppPhoneNumber200Response]
@@ -631,7 +631,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchaseWhatsAppPhoneNumber200Response, Integer, Hash)>] PurchaseWhatsAppPhoneNumber200Response data, response status code and response headers

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

@@ -20,6 +20,7 @@ module Zernio
 
     attr_accessor :tier
 
+    # Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3.
     attr_accessor :monthly_cents
 
     attr_accessor :needs_kyc

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

@@ -21,6 +21,7 @@ module Zernio
 
     attr_accessor :needs_kyc
 
+    # Price a NEW number of this type costs per month, in cents.
     attr_accessor :monthly_cents
 
     # Always false for toll_free (WhatsApp does not reliably register toll-free numbers).

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

@@ -29,7 +29,7 @@ module Zernio
     # Present once the number order has been placed (i.e. the requirement group was approved). Absent while still in identity review.
     attr_accessor :telnyx_order_id
 
-    # Per-country monthly price in cents ($2..$25).
+    # What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes.
     attr_accessor :monthly_cents
 
     # 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.

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

@@ -20,6 +20,7 @@ module Zernio
 
     attr_accessor :tier
 
+    # Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3.
     attr_accessor :monthly_cents
 
     attr_accessor :needs_kyc

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -27032,7 +27032,7 @@ paths:
           in: path
           required: true
           schema: { type: string }
-          description: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+          description: 'Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.'
         - name: accountId
           in: query
           required: true
@@ -27169,7 +27169,7 @@ paths:
           in: path
           required: true
           schema: { type: string }
-          description: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+          description: 'Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.'
       requestBody:
         required: true
         content:
@@ -27249,7 +27249,7 @@ paths:
           in: path
           required: true
           schema: { type: string }
-          description: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+          description: 'Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.'
         - name: accountId
           in: query
           required: true
@@ -33947,7 +33947,7 @@ paths:
                         status: { type: string, enum: [pending_payment, pending_regulatory, regulatory_declined, provisioning, verifying, active, suspended, releasing, released] }
                         registrantName: { type: [string, "null"], description: "For regulated numbers, who it's registered for (company or person) — set from the submitted KYC." }
                         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). }
+                        monthlyCents: { type: integer, description: "What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes." }
                         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 }
@@ -34097,6 +34097,10 @@ paths:
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
 
+        The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that
+        country and `numberType` at the time of purchase, and it is stamped on the number:
+        later rate-card changes never move a number you already own.
+
         Requires usage-based billing (the Usage plan). The maximum number of phone numbers
         is determined by the user's plan.
       security:
@@ -34299,7 +34303,7 @@ paths:
                       properties:
                         code: { type: string, description: ISO 3166-1 alpha-2 }
                         tier: { type: integer, enum: [1, 2, 3, 4] }
-                        monthlyCents: { type: integer }
+                        monthlyCents: { type: integer, description: "Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3." }
                         needsKyc: { type: boolean }
                         callsAvailable: { type: boolean, description: "Regular phone (PSTN) calling on the number, inbound + outbound. Available on every offerable country." }
                         whatsappAvailable: { type: boolean, description: WhatsApp can be enabled on numbers from this country. }
@@ -34320,7 +34324,7 @@ paths:
                               numberType: { type: string, enum: [local, mobile, national, toll_free] }
                               tier: { type: integer, enum: [1, 2, 3, 4] }
                               needsKyc: { type: boolean }
-                              monthlyCents: { type: integer }
+                              monthlyCents: { type: integer, description: "Price a NEW number of this type costs per month, in cents." }
                               whatsappAvailable: { type: boolean, description: "Always false for toll_free (WhatsApp does not reliably register toll-free numbers)." }
                               smsAvailable: { type: boolean }
                               callsAvailable: { type: boolean }
@@ -34491,7 +34495,7 @@ paths:
                         status: { type: string, enum: [pending_payment, pending_regulatory, regulatory_declined, provisioning, verifying, active, suspended, releasing, released] }
                         registrantName: { type: [string, "null"], description: "For regulated numbers, who it's registered for (company or person) — set from the submitted KYC." }
                         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). }
+                        monthlyCents: { type: integer, description: "What this number bills each month, in cents. Stamped when the number was bought, so an existing number keeps its price when the rate card changes." }
                         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 }
@@ -34557,6 +34561,10 @@ paths:
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
 
+        The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that
+        country and `numberType` at the time of purchase, and it is stamped on the number:
+        later rate-card changes never move a number you already own.
+
         Requires usage-based billing (the Usage plan). The maximum number of phone numbers
         is determined by the user's plan.
       security:
@@ -34700,7 +34708,7 @@ paths:
                       properties:
                         code: { type: string, description: ISO 3166-1 alpha-2 }
                         tier: { type: integer, enum: [1, 2, 3, 4] }
-                        monthlyCents: { type: integer }
+                        monthlyCents: { type: integer, description: "Price a NEW number in this country costs per month, in cents, for the default (first) type. 1.5x the carrier's monthly cost, rounded up to a whole dollar, minimum $3." }
                         needsKyc: { type: boolean }
                         outboundCallingAvailable: { type: boolean }
         '401': { $ref: '#/components/responses/Unauthorized' }

data/spec/api/messages_api_spec.rb

@@ -89,7 +89,7 @@ describe 'MessagesApi' do
   # unit tests for get_inbox_conversation
   # Get conversation
   # Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
-  # @param conversation_id The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+  # @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 account_id The social account ID
   # @param [Hash] opts the optional parameters
   # @return [GetInboxConversation200Response]
@@ -102,7 +102,7 @@ describe 'MessagesApi' do
   # unit tests for get_inbox_conversation_messages
   # List messages
   # Fetch messages for a specific conversation, with cursor-based pagination and ordering control.  Pagination: pass `pagination.nextCursor` from a prior response back as the `cursor` query param to fetch the next page. The cursor is opaque; do not parse or construct it client-side.  Sort order: defaults to `asc` (oldest first, chat style). For the \"show me the latest messages\" pattern, pass `?sortOrder=desc&limit=N`. Twitter, Instagram, Telegram, WhatsApp and Reddit honor the requested order from the local message store. For Facebook and Bluesky, the upstream APIs only return newest-first and have no order parameter — sort order is best-effort and only reverses items within a single page (pages still walk newest→oldest). The response field `sortOrderApplied` tells you what was actually applied.  Reddit threads are paginated client-side because Reddit's API has no per-thread cursor. Very long threads may be upstream-truncated by Reddit's inbox/sent windows (~100 most-recent items each); this is a Reddit platform limitation.  Instagram and Facebook conversations include history from before the account was connected, replayed from Meta. That replay covers the 500 most recent messages per conversation: a longer thread keeps its newest 500 and older messages are not retrievable. Messages that arrived after the account was connected are unaffected. Replayed messages are stored as already read and emit no webhooks.  Twitter/X limitation: X's encrypted \"X Chat\" messages are not accessible via the API. Conversations where the other participant uses encrypted X Chat may only show your outgoing messages. See the list conversations endpoint for more details.  This endpoint is read-only and does NOT mark messages as read or send read receipts. To mark a conversation read (and send WhatsApp blue ticks on eligible accounts), call `POST /v1/inbox/conversations/{conversationId}/read`. 
-  # @param conversation_id The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+  # @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 account_id Social account ID
   # @param [Hash] opts the optional parameters
   # @option opts [Integer] :limit Number of messages to return per page. Default 100, max 100.
@@ -224,7 +224,7 @@ describe 'MessagesApi' do
   # unit tests for update_inbox_conversation
   # Update conversation status
   # Archive or activate a conversation. Requires accountId in request body.
-  # @param conversation_id The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+  # @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 update_inbox_conversation_request 
   # @param [Hash] opts the optional parameters
   # @return [UpdateInboxConversation200Response]

data/spec/api/phone_numbers_api_spec.rb

@@ -226,7 +226,7 @@ describe 'PhoneNumbersApi' do
 
   # unit tests for purchase_phone_number
   # Purchase phone number
-  # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchasePhoneNumber200Response]

data/spec/api/whats_app_phone_numbers_api_spec.rb

@@ -146,7 +146,7 @@ describe 'WhatsAppPhoneNumbersApi' do
 
   # unit tests for purchase_whats_app_phone_number
   # Purchase phone number
-  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_whats_app_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchaseWhatsAppPhoneNumber200Response]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.830
+  version: 0.0.832
 platform: ruby
 authors:
 - OpenAPI-Generator