zernio-sdk 0.0.553 → 0.0.555

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cb0f3bc4604dcf8646e158f9466a1acf7d5890cd902469ab2f19b2784eb70a4
-  data.tar.gz: db93724947c7625d852a01d3626dd31c124211a62e604fac3e0ca3562c8b3579
+  metadata.gz: 030a3399a6d872a9f98f741053d87d2a129d70ee8a0d908a4137587e0fc17412
+  data.tar.gz: ff9c216ca793ff273f6b15fa7611b2373e2b3769805a7276b71ae693bc4d30a1
 SHA512:
-  metadata.gz: bfb2a29d234e3bbdef08052bbb8ea2bbb741ed240e8f2522da70f6b43a80cc00eef9a51f233294159501f0f06a45b89e03fd4d5ab3339ae00c978315a8163447
-  data.tar.gz: 9ae4916481ed0b33e538f918273b7eac8748c1192ff6b39242a5472fad038882c90d19125e7d454290ddad03ef39ab9cd255cab570573e4147e23670ae3bcaed
+  metadata.gz: 11075faf7b7f4287420dfc5a2f9afe06930daea2b55a8448420d407e757c1a2ebb1e475b381547fa8840d8b08188672fdae7d9ecc63bbac49af2ccdd0e9338af
+  data.tar.gz: 39262e6b6e4a464c1357872e4d01158c6f2df9e0fbe78081163d63fd06bf232c3e3e150a9b6e141e92b50631f1746e9bdf2ed29fbc5e0a031b6558f6ba2c40e0

data/docs/GetPhoneNumberKycForm200ResponseReusableOptionsInner.md

@@ -4,7 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **from_phone_number** | **String** |  | [optional] |
+| **id** | **String** | Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications). | [optional] |
+| **from_phone_number** | **String** | Display only — the number this verification was submitted for. Not a selection key. | [optional] |
+| **instant** | **Boolean** | true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days). | [optional] |
 | **details** | [**Array<GetPhoneNumberKycForm200ResponseReusableDetailsInner>**](GetPhoneNumberKycForm200ResponseReusableDetailsInner.md) |  | [optional] |
 
 ## Example
@@ -13,7 +15,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInner.new(
+  id: null,
   from_phone_number: null,
+  instant: null,
   details: null
 )
 ```

data/docs/SubmitPhoneNumberKycRequest.md

@@ -9,7 +9,8 @@
 | **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
-| **reuse_from** | **String** | Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409. | [optional] |
+| **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409. | [optional] |
+| **reuse_from** | **String** | Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409. | [optional] |
 | **end_user_first_name** | **String** | End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. | [optional] |
 | **end_user_last_name** | **String** | End user's legal last name. Same condition as endUserFirstName. | [optional] |
 | **values** | **Hash<String, String>** | requirementId → textual value | [optional] |
@@ -27,6 +28,7 @@ instance = Zernio::SubmitPhoneNumberKycRequest.new(
   submission_id: null,
   quantity: null,
   reuse: null,
+  reuse_option_id: null,
   reuse_from: null,
   end_user_first_name: null,
   end_user_last_name: null,

data/docs/SubmitWhatsAppNumberKycRequest.md

@@ -9,7 +9,8 @@
 | **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
-| **reuse_from** | **String** | Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409. | [optional] |
+| **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409. | [optional] |
+| **reuse_from** | **String** | Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409. | [optional] |
 | **end_user_first_name** | **String** | End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. | [optional] |
 | **end_user_last_name** | **String** | End user's legal last name. Same condition as endUserFirstName. | [optional] |
 | **values** | **Hash<String, String>** | requirementId → textual value | [optional] |
@@ -27,6 +28,7 @@ instance = Zernio::SubmitWhatsAppNumberKycRequest.new(
   submission_id: null,
   quantity: null,
   reuse: null,
+  reuse_option_id: null,
   reuse_from: null,
   end_user_first_name: null,
   end_user_last_name: null,

data/docs/UpdateAdSetRequest.md

@@ -8,9 +8,9 @@
 | **budget** | [**UpdateAdSetRequestBudget**](UpdateAdSetRequestBudget.md) |  | [optional] |
 | **status** | **String** | Omit if not toggling delivery state | [optional] |
 | **name** | **String** | Rename the ad set (Meta only; other platforms return 501). At least one of budget/status/bidStrategy/name is required. | [optional] |
-| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Ad-set-level bid strategy. Overrides the campaign-level default. Supported on Meta (facebook, instagram) and TikTok. On TikTok the Meta-style enum is mapped to bid_type / bid_price / deep_bid_type automatically. Other platforms (linkedin, pinterest, google, twitter) return 501 Not Implemented when bidStrategy is set.  | [optional] |
-| **bid_amount** | **Float** | Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's smallest-denomination integer.  | [optional] |
-| **roas_average_floor** | **Float** | Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.  | [optional] |
+| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Ad-set-level bid strategy. Overrides the campaign-level default. Supported on Meta (facebook, instagram), TikTok, and OpenAI. On TikTok the Meta-style enum is mapped to bid_type / bid_price / deep_bid_type automatically. On OpenAI, LOWEST_COST_WITH_BID_CAP and COST_CAP both map to the ad group's `bidding_config.max_bid_micros` (one knob covers both); LOWEST_COST_WITH_MIN_ROAS is rejected with 422 (OpenAI has no ROAS-based bidding). Other platforms (linkedin, pinterest, google, twitter) return 501 Not Implemented when bidStrategy is set.  | [optional] |
+| **bid_amount** | **Float** | Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).  | [optional] |
+| **roas_average_floor** | **Float** | Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000. Not supported on OpenAI (422).  | [optional] |
 | **platform_specific_data** | [**UpdateAdSetRequestPlatformSpecificData**](UpdateAdSetRequestPlatformSpecificData.md) |  | [optional] |
 
 ## Example

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
+  # Present when this account already has a reusable verification for the country (skip the form). `fromPhoneNumber`/`details` mirror the first option; `options` lists ALL reusable verifications (agencies hold one per end client), approved-first. Pass the chosen option's `id` as `reuseOptionId` on POST. Each option's `instant` says whether it activates in minutes (group-approved) or still queues for carrier review (1-3 days).
   class GetPhoneNumberKycForm200ResponseReusable < ApiModelBase
     attr_accessor :available
 

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

@@ -15,14 +15,23 @@ require 'time'
 
 module Zernio
   class GetPhoneNumberKycForm200ResponseReusableOptionsInner < ApiModelBase
+    # Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications).
+    attr_accessor :id
+
+    # Display only — the number this verification was submitted for. Not a selection key.
     attr_accessor :from_phone_number
 
+    # true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days).
+    attr_accessor :instant
+
     attr_accessor :details
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'id' => :'id',
         :'from_phone_number' => :'fromPhoneNumber',
+        :'instant' => :'instant',
         :'details' => :'details'
       }
     end
@@ -40,7 +49,9 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'id' => :'String',
         :'from_phone_number' => :'String',
+        :'instant' => :'Boolean',
         :'details' => :'Array<GetPhoneNumberKycForm200ResponseReusableDetailsInner>'
       }
     end
@@ -67,10 +78,18 @@ module Zernio
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      end
+
       if attributes.key?(:'from_phone_number')
         self.from_phone_number = attributes[:'from_phone_number']
       end
 
+      if attributes.key?(:'instant')
+        self.instant = attributes[:'instant']
+      end
+
       if attributes.key?(:'details')
         if (value = attributes[:'details']).is_a?(Array)
           self.details = value
@@ -98,7 +117,9 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          id == o.id &&
           from_phone_number == o.from_phone_number &&
+          instant == o.instant &&
           details == o.details
     end
 
@@ -111,7 +132,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [from_phone_number, details].hash
+      [id, from_phone_number, instant, details].hash
     end
 
     # Builds the object from hash

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

@@ -28,7 +28,10 @@ module Zernio
     # Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
     attr_accessor :reuse
 
-    # Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+    # Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
+    attr_accessor :reuse_option_id
+
+    # Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
     attr_accessor :reuse_from
 
     # End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
@@ -53,6 +56,7 @@ module Zernio
         :'submission_id' => :'submissionId',
         :'quantity' => :'quantity',
         :'reuse' => :'reuse',
+        :'reuse_option_id' => :'reuseOptionId',
         :'reuse_from' => :'reuseFrom',
         :'end_user_first_name' => :'endUserFirstName',
         :'end_user_last_name' => :'endUserLastName',
@@ -80,6 +84,7 @@ module Zernio
         :'submission_id' => :'String',
         :'quantity' => :'Integer',
         :'reuse' => :'Boolean',
+        :'reuse_option_id' => :'String',
         :'reuse_from' => :'String',
         :'end_user_first_name' => :'String',
         :'end_user_last_name' => :'String',
@@ -137,6 +142,10 @@ module Zernio
         self.reuse = attributes[:'reuse']
       end
 
+      if attributes.key?(:'reuse_option_id')
+        self.reuse_option_id = attributes[:'reuse_option_id']
+      end
+
       if attributes.key?(:'reuse_from')
         self.reuse_from = attributes[:'reuse_from']
       end
@@ -249,6 +258,7 @@ module Zernio
           submission_id == o.submission_id &&
           quantity == o.quantity &&
           reuse == o.reuse &&
+          reuse_option_id == o.reuse_option_id &&
           reuse_from == o.reuse_from &&
           end_user_first_name == o.end_user_first_name &&
           end_user_last_name == o.end_user_last_name &&
@@ -266,7 +276,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, submission_id, quantity, reuse, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
+      [profile_id, country, submission_id, quantity, reuse, reuse_option_id, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
     end
 
     # Builds the object from hash

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

@@ -28,7 +28,10 @@ module Zernio
     # Reuse a prior approved verification for this country (skips document/field collection; places the order immediately).
     attr_accessor :reuse
 
-    # Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.
+    # Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.
+    attr_accessor :reuse_option_id
+
+    # Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.
     attr_accessor :reuse_from
 
     # End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
@@ -53,6 +56,7 @@ module Zernio
         :'submission_id' => :'submissionId',
         :'quantity' => :'quantity',
         :'reuse' => :'reuse',
+        :'reuse_option_id' => :'reuseOptionId',
         :'reuse_from' => :'reuseFrom',
         :'end_user_first_name' => :'endUserFirstName',
         :'end_user_last_name' => :'endUserLastName',
@@ -80,6 +84,7 @@ module Zernio
         :'submission_id' => :'String',
         :'quantity' => :'Integer',
         :'reuse' => :'Boolean',
+        :'reuse_option_id' => :'String',
         :'reuse_from' => :'String',
         :'end_user_first_name' => :'String',
         :'end_user_last_name' => :'String',
@@ -137,6 +142,10 @@ module Zernio
         self.reuse = attributes[:'reuse']
       end
 
+      if attributes.key?(:'reuse_option_id')
+        self.reuse_option_id = attributes[:'reuse_option_id']
+      end
+
       if attributes.key?(:'reuse_from')
         self.reuse_from = attributes[:'reuse_from']
       end
@@ -249,6 +258,7 @@ module Zernio
           submission_id == o.submission_id &&
           quantity == o.quantity &&
           reuse == o.reuse &&
+          reuse_option_id == o.reuse_option_id &&
           reuse_from == o.reuse_from &&
           end_user_first_name == o.end_user_first_name &&
           end_user_last_name == o.end_user_last_name &&
@@ -266,7 +276,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, submission_id, quantity, reuse, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
+      [profile_id, country, submission_id, quantity, reuse, reuse_option_id, reuse_from, end_user_first_name, end_user_last_name, values, documents, address].hash
     end
 
     # Builds the object from hash

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

@@ -25,13 +25,13 @@ module Zernio
     # Rename the ad set (Meta only; other platforms return 501). At least one of budget/status/bidStrategy/name is required.
     attr_accessor :name
 
-    # Ad-set-level bid strategy. Overrides the campaign-level default. Supported on Meta (facebook, instagram) and TikTok. On TikTok the Meta-style enum is mapped to bid_type / bid_price / deep_bid_type automatically. Other platforms (linkedin, pinterest, google, twitter) return 501 Not Implemented when bidStrategy is set. 
+    # Ad-set-level bid strategy. Overrides the campaign-level default. Supported on Meta (facebook, instagram), TikTok, and OpenAI. On TikTok the Meta-style enum is mapped to bid_type / bid_price / deep_bid_type automatically. On OpenAI, LOWEST_COST_WITH_BID_CAP and COST_CAP both map to the ad group's `bidding_config.max_bid_micros` (one knob covers both); LOWEST_COST_WITH_MIN_ROAS is rejected with 422 (OpenAI has no ROAS-based bidding). Other platforms (linkedin, pinterest, google, twitter) return 501 Not Implemented when bidStrategy is set. 
     attr_accessor :bid_strategy
 
-    # Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's smallest-denomination integer. 
+    # Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000). 
     attr_accessor :bid_amount
 
-    # Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000. 
+    # Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000. Not supported on OpenAI (422). 
     attr_accessor :roas_average_floor
 
     attr_accessor :platform_specific_data

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -28469,7 +28469,7 @@ paths:
                         localTo: { type: [string, "null"], description: ISO country the value must be local to }
                   reusable:
                     type: [object, "null"]
-                    description: Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
+                    description: 'Present when this account already has a reusable verification for the country (skip the form). `fromPhoneNumber`/`details` mirror the first option; `options` lists ALL reusable verifications (agencies hold one per end client), approved-first. Pass the chosen option''s `id` as `reuseOptionId` on POST. Each option''s `instant` says whether it activates in minutes (group-approved) or still queues for carrier review (1-3 days).'
                     properties:
                       available: { type: boolean }
                       fromPhoneNumber: { type: string }
@@ -28487,7 +28487,9 @@ paths:
                         items:
                           type: object
                           properties:
-                            fromPhoneNumber: { type: string }
+                            id: { type: string, description: 'Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications).' }
+                            fromPhoneNumber: { type: string, description: Display only — the number this verification was submitted for. Not a selection key. }
+                            instant: { type: boolean, description: 'true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days).' }
                             details:
                               type: array
                               items:
@@ -28534,7 +28536,8 @@ paths:
                 submissionId: { type: string, description: Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. }
                 quantity: { type: integer, minimum: 1, maximum: 5, default: 1, description: 'Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort).' }
                 reuse: { type: boolean, description: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). }
-                reuseFrom: { type: string, description: 'Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.' }
+                reuseOptionId: { type: string, description: 'Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.' }
+                reuseFrom: { type: string, description: 'Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.' }
                 endUserFirstName: { type: string, description: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. }
                 endUserLastName: { type: string, description: End user's legal last name. Same condition as endUserFirstName. }
                 values:
@@ -29274,7 +29277,7 @@ paths:
                         audience: { type: [string, "null"], enum: [business, individual, null], description: 'When set, the requirement applies ONLY to this end-user type — provide it for that type and OMIT it for the other (e.g. Brazil: "Cartão CNPJ" is business-only, "CPF" and "ID/Passport Copy" are personal-only). Submitting both sets makes the regulator ask whether the number is for personal or business use and stalls the review. Pass `entityType` on POST so the server drops the inapplicable set.' }
                   reusable:
                     type: [object, "null"]
-                    description: Present when this account already has an approved verification for the country that can be reused (skip the form). `fromPhoneNumber`/`details` mirror the newest option; `options` lists ALL approved verifications (agencies hold one per end client) — pass the chosen option's `fromPhoneNumber` as `reuseFrom` on POST.
+                    description: 'Present when this account already has a reusable verification for the country (skip the form). `fromPhoneNumber`/`details` mirror the first option; `options` lists ALL reusable verifications (agencies hold one per end client), approved-first. Pass the chosen option''s `id` as `reuseOptionId` on POST. Each option''s `instant` says whether it activates in minutes (group-approved) or still queues for carrier review (1-3 days).'
                     properties:
                       available: { type: boolean }
                       fromPhoneNumber: { type: string }
@@ -29292,7 +29295,9 @@ paths:
                         items:
                           type: object
                           properties:
-                            fromPhoneNumber: { type: string }
+                            id: { type: string, description: 'Opaque option id — pass as `reuseOptionId` on POST. Stable selection key (a phone number is not unique across verifications).' }
+                            fromPhoneNumber: { type: string, description: Display only — the number this verification was submitted for. Not a selection key. }
+                            instant: { type: boolean, description: 'true = group-approved, a new order activates in minutes; false = documents are reused but the order still queues for carrier review (1-3 days).' }
                             details:
                               type: array
                               items:
@@ -29343,7 +29348,8 @@ paths:
                 submissionId: { type: string, description: Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. }
                 quantity: { type: integer, minimum: 1, maximum: 5, default: 1, description: 'Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort).' }
                 reuse: { type: boolean, description: Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). }
-                reuseFrom: { type: string, description: 'Which approved verification to reuse when several exist: the phone number it was originally approved for (GET reusable.options[].fromPhoneNumber). Omitted = newest. No match = 409.' }
+                reuseOptionId: { type: string, description: 'Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted = the approved default. No match = 409.' }
+                reuseFrom: { type: string, description: 'Legacy fallback for `reuseOptionId`: the source phone number (GET reusable.options[].fromPhoneNumber). Ambiguous when a number labels two verifications — prefer `reuseOptionId`. Omitted = the approved default. No match = 409.' }
                 endUserFirstName: { type: string, description: End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement. }
                 endUserLastName: { type: string, description: End user's legal last name. Same condition as endUserFirstName. }
                 values:
@@ -33921,7 +33927,7 @@ paths:
     put:
       operationId: updateAdSet
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta", "tiktok"]
+      x-platforms: ["meta", "tiktok", "openai"]
       summary: Update an ad set
       description: |
         Ad-set-level writes. Use this for ABO budget updates, ad-set-scoped
@@ -33966,21 +33972,25 @@ paths:
                   allOf: [{ $ref: '#/components/schemas/BidStrategy' }]
                   description: |
                     Ad-set-level bid strategy. Overrides the campaign-level default.
-                    Supported on Meta (facebook, instagram) and TikTok. On TikTok the
+                    Supported on Meta (facebook, instagram), TikTok, and OpenAI. On TikTok the
                     Meta-style enum is mapped to bid_type / bid_price / deep_bid_type
-                    automatically. Other platforms (linkedin, pinterest, google, twitter)
-                    return 501 Not Implemented when bidStrategy is set.
+                    automatically. On OpenAI, LOWEST_COST_WITH_BID_CAP and COST_CAP both map to
+                    the ad group's `bidding_config.max_bid_micros` (one knob covers both);
+                    LOWEST_COST_WITH_MIN_ROAS is rejected with 422 (OpenAI has no ROAS-based
+                    bidding). Other platforms (linkedin, pinterest, google, twitter) return 501
+                    Not Implemented when bidStrategy is set.
                 bidAmount:
                   type: number
                   description: |
                     Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
                     bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
-                    smallest-denomination integer.
+                    smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).
                 roasAverageFloor:
                   type: number
                   description: |
                     Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is
                     LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as `bid_constraints.roas_average_floor` × 10000.
+                    Not supported on OpenAI (422).
                 platformSpecificData:
                   type: object
                   description: |
@@ -34027,7 +34037,8 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Ad set not found }
         '409': { description: "Campaign is CBO — route to /v1/ads/campaigns/{campaignId} instead" }
-        '501': { description: "bidStrategy not supported on the platform (Meta + TikTok only)" }
+        '422': { description: "bidStrategy is LOWEST_COST_WITH_MIN_ROAS on OpenAI (unsupported: no ROAS-based bidding)" }
+        '501': { description: "bidStrategy not supported on the platform (Meta, TikTok, and OpenAI only)" }
 
   /v1/ads/ad-sets/{adSetId}/status:
     put:

data/spec/models/get_phone_number_kyc_form200_response_reusable_options_inner_spec.rb

@@ -27,12 +27,24 @@ describe Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInner do
     end
   end
 
+  describe 'test attribute "id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "from_phone_number"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
+  describe 'test attribute "instant"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "details"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/submit_phone_number_kyc_request_spec.rb

@@ -57,6 +57,12 @@ describe Zernio::SubmitPhoneNumberKycRequest do
     end
   end
 
+  describe 'test attribute "reuse_option_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "reuse_from"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/submit_whats_app_number_kyc_request_spec.rb

@@ -57,6 +57,12 @@ describe Zernio::SubmitWhatsAppNumberKycRequest do
     end
   end
 
+  describe 'test attribute "reuse_option_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "reuse_from"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

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