late-sdk 0.0.782 → 0.0.784

data/lib/zernio-sdk.rb

@@ -278,6 +278,7 @@ require 'zernio-sdk/models/create_phone_number_port_in201_response_orders_inner'
 require 'zernio-sdk/models/create_phone_number_port_in_request'
 require 'zernio-sdk/models/create_phone_number_port_in_request_end_user'
 require 'zernio-sdk/models/create_phone_number_port_in_request_requirements_inner'
+require 'zernio-sdk/models/create_phone_number_stock_watch_request'
 require 'zernio-sdk/models/create_pinterest_board201_response'
 require 'zernio-sdk/models/create_pinterest_board201_response_board'
 require 'zernio-sdk/models/create_pinterest_board_request'
@@ -1005,6 +1006,7 @@ require 'zernio-sdk/models/list_phone_number_countries200_response_countries_inn
 require 'zernio-sdk/models/list_phone_number_countries200_response_countries_inner_types_inner'
 require 'zernio-sdk/models/list_phone_number_port_ins200_response'
 require 'zernio-sdk/models/list_phone_number_port_ins200_response_orders_inner'
+require 'zernio-sdk/models/list_phone_number_stock_watches200_response'
 require 'zernio-sdk/models/list_phone_numbers200_response'
 require 'zernio-sdk/models/list_phone_numbers200_response_connected_inner'
 require 'zernio-sdk/models/list_phone_numbers200_response_numbers_inner'
@@ -1107,6 +1109,7 @@ require 'zernio-sdk/models/on_whats_app_number_verification_required_request'
 require 'zernio-sdk/models/pagination'
 require 'zernio-sdk/models/pause_workflow200_response'
 require 'zernio-sdk/models/pending'
+require 'zernio-sdk/models/phone_number_stock_watch'
 require 'zernio-sdk/models/pin_discord_message200_response'
 require 'zernio-sdk/models/pinterest_platform_data'
 require 'zernio-sdk/models/platform_analytics'
@@ -1557,13 +1560,19 @@ require 'zernio-sdk/models/uploaded_file'
 require 'zernio-sdk/models/uploaded_or_derived_audience'
 require 'zernio-sdk/models/uploaded_or_derived_audience_companies_inner'
 require 'zernio-sdk/models/uploaded_or_derived_audience_match_rules_inner'
+require 'zernio-sdk/models/usage_attribution_group'
+require 'zernio-sdk/models/usage_attribution_slice'
+require 'zernio-sdk/models/usage_attribution_slice_by_product'
 require 'zernio-sdk/models/usage_metering'
+require 'zernio-sdk/models/usage_metering_attribution'
 require 'zernio-sdk/models/usage_metering_call_usage'
 require 'zernio-sdk/models/usage_metering_call_usage_whatsapp'
 require 'zernio-sdk/models/usage_metering_days_inner'
 require 'zernio-sdk/models/usage_metering_line_items_inner'
 require 'zernio-sdk/models/usage_metering_peaks'
 require 'zernio-sdk/models/usage_metering_period'
+require 'zernio-sdk/models/usage_metering_scope'
+require 'zernio-sdk/models/usage_metering_scope_one_of'
 require 'zernio-sdk/models/usage_metering_tax'
 require 'zernio-sdk/models/usage_metering_totals'
 require 'zernio-sdk/models/usage_stats'
@@ -1664,6 +1673,9 @@ require 'zernio-sdk/models/webhook_payload_message_sent_message'
 require 'zernio-sdk/models/webhook_payload_message_sent_message_attachments_inner'
 require 'zernio-sdk/models/webhook_payload_message_sent_message_sender'
 require 'zernio-sdk/models/webhook_payload_message_sent_metadata'
+require 'zernio-sdk/models/webhook_payload_phone_number_stock_available'
+require 'zernio-sdk/models/webhook_payload_phone_number_stock_available_stock'
+require 'zernio-sdk/models/webhook_payload_phone_number_stock_available_stock_types_inner'
 require 'zernio-sdk/models/webhook_payload_post'
 require 'zernio-sdk/models/webhook_payload_post_platform'
 require 'zernio-sdk/models/webhook_payload_post_platform_account'

data/openapi.yaml

@@ -182,6 +182,7 @@ x-documentation:
     - `call.failed` - A call failed with a hard error before or during bridging
     - `call.permission_request` - A WhatsApp user accepted or rejected your call-permission request
     - `whatsapp.automatic_event` - Meta's automatic event identification detected a lead or purchase in a Click-to-WhatsApp conversation. Branch on `eventName` (`LeadSubmitted` | `Purchase`); carries the `ctwa_clid` Conversions API match key
+    - `phone_number.stock_available` - An out-of-stock country you watch (POST /v1/phone-numbers/stock-watches) has deliverable numbers again. Fires once per watch, then the watch is consumed. Carries the deliverable count per number type at sweep time (first come, first served).
     - `whatsapp.number.kyc_submitted` - An end customer completed a hosted KYC share link; the number entered regulatory review under your account
     - `whatsapp.number.activated` - A provisioned WhatsApp number finished setup and is ready to connect
     - `whatsapp.number.declined` - A regulated number order was declined in review; nothing activates and nothing is billed
@@ -430,7 +431,7 @@ tags:
   - name: Webhooks
     description: |
       Configure webhooks for real-time notifications. Webhooks can be created from the dashboard (Settings → Webhooks) or via this API.
-      Events: post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, verification.approved, verification.failed, webhook.test.
+      Events: post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, phone_number.stock_available, verification.approved, verification.failed, webhook.test.
       Security: optional HMAC-SHA256 signature in X-Zernio-Signature header. Configure a secret key to enable verification. Custom headers supported.
 
       Resource groups. Every event belongs to one group: post.* to publishing, message.*, reaction.*, conversation.*, call.* and whatsapp.automatic_event to messages, comment.* and review.* to engagement, lead.* to contacts, ad.* to ads, account.*, whatsapp.template.* and whatsapp.account.* to accounts, whatsapp.number.* and verification.* to telephony, webhook.test to webhooks. Two independent controls use that mapping. (1) A restricted (zrk_) API key can only subscribe to, test-fire, redeliver, or read delivery logs for events in the groups it holds, so it can never create a subscription broader than itself. (2) Each subscription carries its own `disabledResourceGroups` denylist: events in a disabled group are dropped before delivery to that endpoint, on live delivery and on every replay path, no matter which key or session created the subscription. Changing that denylist applies to every event emitted after the change; events already queued when it landed can still be delivered for up to five minutes after they were enqueued, because the delivery worker trusts a five-minute enqueue-time snapshot before re-checking. Absent or empty on a subscription means it receives everything it subscribes to, which is the behavior of every subscription created before the field existed.
@@ -2430,7 +2431,7 @@ components:
           type: array
           items:
             type: string
-            enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, verification.approved, verification.failed]
+            enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, phone_number.stock_available, verification.approved, verification.failed]
           description: Events subscribed to
         isActive:
           type: boolean
@@ -2692,6 +2693,45 @@ components:
           type: string
           format: date-time
           description: 'UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.'
+    PhoneNumberStockWatch:
+      type: object
+      required: [id, country, countryName, createdAt]
+      properties:
+        id: { type: string }
+        country: { type: string, description: 'ISO 3166-1 alpha-2.' }
+        countryName: { type: string }
+        createdAt: { type: string, format: date-time }
+    WebhookPayloadPhoneNumberStockAvailable:
+      type: object
+      description: Webhook payload for phone_number.stock_available events
+      required: [id, event, stock, timestamp]
+      properties:
+        id:
+          type: string
+          description: Stable webhook event ID
+        event:
+          type: string
+          enum: [phone_number.stock_available]
+        stock:
+          type: object
+          required: [country, types]
+          properties:
+            country:
+              type: string
+              description: 'ISO 3166-1 alpha-2 country code of the watched country.'
+            types:
+              type: array
+              description: 'Number types deliverable at sweep time. Only types with stock are listed.'
+              items:
+                type: object
+                required: [numberType, availableCount]
+                properties:
+                  numberType: { type: string, description: 'local, mobile, national or toll_free.' }
+                  availableCount: { type: integer, description: 'Deliverable numbers at sweep time; first come, first served.' }
+        timestamp:
+          type: string
+          format: date-time
+          description: 'UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.'
     WebhookPayloadAccountDisconnected:
       type: object
       description: Webhook payload for account disconnected events
@@ -6960,14 +7000,14 @@ components:
               totalUsd: { type: number }
               quantity: { type: number }
         peaks:
-          type: object
-          description: Peak counts over the window (Metronome COUNT metrics + live active-number count).
+          type: [object, "null"]
+          description: 'Peak counts over the window (Metronome COUNT metrics + live active-number count). Null when `profileId` / `accountId` is set.'
           properties:
             accounts: { type: integer }
             numbers: { type: integer }
         callUsage:
-          type: object
-          description: Billable call volumes over the window.
+          type: [object, "null"]
+          description: 'Billable call volumes over the window. Null when `profileId` / `accountId` is set.'
           properties:
             whatsapp:
               type: object
@@ -7001,6 +7041,61 @@ components:
             ratePercent: { type: [number, "null"], description: "Combined rate percentage, e.g. 21." }
             jurisdictionLabel: { type: [string, "null"], description: 'Human jurisdiction label, e.g. "ES VAT" or "WA sales tax".' }
             reverseCharge: { type: boolean, description: True for EU/UK B2B reverse charge (0 tax added by design). }
+        attribution:
+          type: object
+          description: 'Present with `groupBy`. The window''s spend split per profile or account; `sum(groups) + unattributed` equals `totals` per product.'
+          properties:
+            groupBy:
+              type: string
+              enum: [profile, account]
+            groups:
+              type: array
+              items:
+                $ref: '#/components/schemas/UsageAttributionGroup'
+            unattributed:
+              $ref: '#/components/schemas/UsageAttributionSlice'
+              description: 'Spend no profile/account can claim: credits, 10DLC fees, Verify, and usage whose record no longer resolves to an account. Zero for a restricted principal.'
+            totals:
+              $ref: '#/components/schemas/UsageAttributionSlice'
+              description: 'The window totals; for a restricted principal, the sum of the visible groups.'
+            restricted:
+              type: boolean
+              description: 'True when the caller (profile-scoped API key or member) cannot see every profile: `groups` are filtered, `totals` sum them, `unattributed` is zero, and the top-level `days` / `totals` / `lineItems` are projected onto the visible groups with `peaks`, `callUsage` and `tax` null.'
+        scope:
+          description: 'Present with `profileId` / `accountId`: echoes the group the payload was projected onto.'
+          oneOf:
+            - type: object
+              required: [profileId]
+              properties:
+                profileId: { type: string }
+            - type: object
+              required: [accountId]
+              properties:
+                accountId: { type: string }
+    UsageAttributionGroup:
+      allOf:
+        - $ref: '#/components/schemas/UsageAttributionSlice'
+        - type: object
+          required: [key]
+          properties:
+            key: { type: string, description: 'Profile id or account id, per `groupBy`.' }
+    UsageAttributionSlice:
+      type: object
+      properties:
+        byProduct:
+          type: object
+          description: USD per product family.
+          properties:
+            accounts: { type: number }
+            numbers: { type: number }
+            calls: { type: number }
+            sms: { type: number }
+            verify: { type: number }
+            dlc: { type: number }
+            xApi: { type: number }
+            credits: { type: number }
+            other: { type: number }
+        totalUsd: { type: number }
     UsageStats:
       type: object
       description: |
@@ -10111,6 +10206,26 @@ webhooks:
       responses:
         '200':
           description: Webhook received successfully
+  phone_number.stock_available:
+    post:
+      operationId: onPhoneNumberStockAvailable
+      summary: Phone-number stock available event
+      description: |
+        Fired by the stock sweep (every 6h) the first time a country you watch
+        via POST /v1/phone-numbers/stock-watches has deliverable numbers again.
+        The watch is consumed, so the event fires once per watch; the stock
+        counts are a snapshot and numbers are sold first come, first served.
+        Buy with POST /v1/phone-numbers/purchase.
+      tags: [Webhook Events]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/WebhookPayloadPhoneNumberStockAvailable'
+      responses:
+        '200':
+          description: Webhook received successfully
   verification.approved:
     post:
       operationId: onVerificationApproved
@@ -13856,6 +13971,20 @@ paths:
         Also served at `GET /v1/usage/daily`. Usage-based accounts only —
         legacy Stripe accounts get `{ "supported": false, "days": [] }`.
 
+        **Attribution (metering mode):** `groupBy=profile|account` adds an
+        `attribution` breakdown of the window's spend per profile or account,
+        assembled from your own records and pro-rated against the invoice so
+        `sum(groups) + unattributed` equals `totals` exactly. `profileId` /
+        `accountId` instead project the whole payload (`days`, `totals`,
+        `lineItems`) onto that one group; `peaks`, `callUsage` and `tax` are
+        then `null` (workspace-level facts). Projected `days` spread the
+        group's period share over each day (usage is attributed per period,
+        not per day). Profile-scoped API keys and members only see their
+        profiles' groups (`attribution.restricted: true`, with `totals`
+        summing the visible groups). Credits, 10DLC fees and Verify are always
+        unattributed. `profileId` / `accountId` on their own do not select
+        metering mode: pair them with `range`.
+
         For per-domain consumption *volumes* use `GET /v1/usage/calls` and
         `GET /v1/usage/sms`. For the billing statement (balance, credits,
         caps, payment status) use `GET /v1/billing`.
@@ -13902,6 +14031,23 @@ paths:
             Bucketing of the `days` series: `day` (one row per UTC day),
             `month` (one row per calendar month, dated to the 1st), or `total`
             (no series — read `totals`). Does not affect `totals`.
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            type: string
+            enum: [profile, account]
+          description: 'Metering mode. Adds `attribution`: the window''s spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`).'
+        - name: profileId
+          in: query
+          required: false
+          schema: { type: string }
+          description: 'Metering mode (pair with `range`). Project the payload onto this profile''s attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key''s profiles).'
+        - name: accountId
+          in: query
+          required: false
+          schema: { type: string }
+          description: 'Metering mode (pair with `range`). Project the payload onto this account''s attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller.'
       responses:
         '200':
           description: |
@@ -24944,7 +25090,7 @@ paths:
                   minItems: 1
                   items:
                     type: string
-                    enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, verification.approved, verification.failed]
+                    enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, phone_number.stock_available, verification.approved, verification.failed]
                   description: Events to subscribe to (at least one required)
                 isActive:
                   type: boolean
@@ -25063,7 +25209,7 @@ paths:
                   minItems: 1
                   items:
                     type: string
-                    enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, verification.approved, verification.failed]
+                    enum: [post.scheduled, post.published, post.failed, post.partial, post.cancelled, post.recycled, post.platform.published, post.platform.failed, post.platform.deleted, post.tiktok.url_resolved, post.external.created, post.external.updated, post.external.deleted, account.connected, account.disconnected, account.ads.initial_sync_completed, message.received, conversation.started, call.received, call.ended, call.failed, call.permission_request, message.sent, message.edited, message.deleted, message.delivered, message.read, message.failed, reaction.received, referral.received, comment.received, review.new, review.updated, lead.received, ad.status_changed, whatsapp.template.status_updated, whatsapp.template.category_updated, whatsapp.account.name_status_updated, whatsapp.automatic_event, whatsapp.number.activated, whatsapp.number.declined, whatsapp.number.action_required, whatsapp.number.verification_required, whatsapp.number.suspended, whatsapp.number.reactivated, whatsapp.number.released, whatsapp.number.kyc_submitted, phone_number.stock_available, verification.approved, verification.failed]
                   description: Events to subscribe to. Must contain at least one event if provided.
                 isActive:
                   type: boolean
@@ -35122,6 +35268,88 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Number not found }
 
+  /v1/phone-numbers/stock-watches:
+    post:
+      x-resource-group: "telephony"
+      operationId: createPhoneNumberStockWatch
+      tags: [Phone Numbers]
+      summary: Watch an out-of-stock country
+      description: |
+        Get notified the first time an out-of-stock country has deliverable
+        numbers again: an email to the account holder plus the
+        `phone_number.stock_available` webhook. Stock is re-checked every 6h.
+        One watch per country; a repeat request returns the existing watch
+        (200). The watch is consumed when it fires, so re-create it if you
+        miss the stock. Up to 20 countries can be watched at once.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [country]
+              properties:
+                country: { type: string, minLength: 2, maxLength: 2, description: 'ISO 3166-1 alpha-2 code of a country listed by GET /v1/phone-numbers/countries.' }
+      responses:
+        '201':
+          description: Watch created.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PhoneNumberStockWatch'
+        '200':
+          description: A watch for this country already existed; returned unchanged.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PhoneNumberStockWatch'
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '409': { description: 'The country is in stock right now (buy instead of watching), or the 20-country watch limit is reached (code invalid_resource_state).' }
+    get:
+      x-resource-group: "telephony"
+      operationId: listPhoneNumberStockWatches
+      tags: [Phone Numbers]
+      summary: List stock watches
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: The caller's active watches, oldest first.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  watches:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/PhoneNumberStockWatch'
+        '401': { $ref: '#/components/responses/Unauthorized' }
+  /v1/phone-numbers/stock-watches/{id}:
+    delete:
+      x-resource-group: "telephony"
+      operationId: deletePhoneNumberStockWatch
+      tags: [Phone Numbers]
+      summary: Stop watching a country
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string } }
+      responses:
+        '200':
+          description: Watch deleted.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  deleted: { type: boolean }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: 'Stock watch not found (code stock_watch_not_found).' }
   /v1/phone-numbers/sip-trunks:
     post:
       x-resource-group: "telephony"

data/spec/api/phone_numbers_api_spec.rb

@@ -94,6 +94,29 @@ describe 'PhoneNumbersApi' do
     end
   end
 
+  # unit tests for create_phone_number_stock_watch
+  # Watch an out-of-stock country
+  # Get notified the first time an out-of-stock country has deliverable numbers again: an email to the account holder plus the `phone_number.stock_available` webhook. Stock is re-checked every 6h. One watch per country; a repeat request returns the existing watch (200). The watch is consumed when it fires, so re-create it if you miss the stock. Up to 20 countries can be watched at once. 
+  # @param create_phone_number_stock_watch_request 
+  # @param [Hash] opts the optional parameters
+  # @return [PhoneNumberStockWatch]
+  describe 'create_phone_number_stock_watch test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for delete_phone_number_stock_watch
+  # Stop watching a country
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [DeleteSmsSenderId200Response]
+  describe 'delete_phone_number_stock_watch test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for get_phone_number
   # Get phone number
   # Retrieve the current status of a purchased phone number. Poll this to track Meta pre-verification (US sync path) and, for regulated (Tier 3/4) numbers, the async lifecycle: pending_regulatory → active (or regulatory_declined). When a regulated number has an Onfido ID step, `onfidoVerificationUrl` appears here once the order is placed — forward it to the end user. (Or subscribe to the whatsapp.number.* webhooks instead of polling.) 
@@ -178,6 +201,16 @@ describe 'PhoneNumbersApi' do
     end
   end
 
+  # unit tests for list_phone_number_stock_watches
+  # List stock watches
+  # @param [Hash] opts the optional parameters
+  # @return [ListPhoneNumberStockWatches200Response]
+  describe 'list_phone_number_stock_watches test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for list_phone_numbers
   # List phone numbers
   # List all phone numbers purchased by the authenticated user. By default, released numbers are excluded. Connected (bring-your-own) WhatsApp numbers are returned in the separate `connected` array; they are not billed and have no provisioning lifecycle. 

data/spec/api/usage_api_spec.rb

@@ -76,13 +76,16 @@ describe 'UsageApi' do
 
   # unit tests for get_usage
   # Usage snapshot (default) or billed-spend metering (with params)
-  # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
+  # Dual-mode endpoint, selected by query params — fully backward compatible:  **Without metering params (the default):** the plan / quota / usage snapshot — plan name, billing period, limits, usage counts, access state. Identical to `GET /v1/usage-stats`. Existing integrations keep working unchanged.  **With `range`, `granularity`, `from`, or `to`:** usage METERING — billed spend (USD) by product family (`accounts`, `numbers`, `calls`, `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at `day` / `month` / `total` granularity, from Metronome's invoice breakdown (the CHARGE view — always reconciles with what gets billed). Also served at `GET /v1/usage/daily`. Usage-based accounts only — legacy Stripe accounts get `{ \"supported\": false, \"days\": [] }`.  **Attribution (metering mode):** `groupBy=profile|account` adds an `attribution` breakdown of the window's spend per profile or account, assembled from your own records and pro-rated against the invoice so `sum(groups) + unattributed` equals `totals` exactly. `profileId` / `accountId` instead project the whole payload (`days`, `totals`, `lineItems`) onto that one group; `peaks`, `callUsage` and `tax` are then `null` (workspace-level facts). Projected `days` spread the group's period share over each day (usage is attributed per period, not per day). Profile-scoped API keys and members only see their profiles' groups (`attribution.restricted: true`, with `totals` summing the visible groups). Credits, 10DLC fees and Verify are always unattributed. `profileId` / `accountId` on their own do not select metering mode: pair them with `range`.  For per-domain consumption *volumes* use `GET /v1/usage/calls` and `GET /v1/usage/sms`. For the billing statement (balance, credits, caps, payment status) use `GET /v1/billing`. 
   # @param [Hash] opts the optional parameters
   # @option opts [Boolean] :reconcile Snapshot mode only. For Stripe subscription users, `true` forces a subscription reconciliation pass even when cached plan data looks complete. 
   # @option opts [String] :range Window to report. `cycle` / `prev-cycle` resolve to the customer's real billing-period bounds (falling back to a trailing 30 days when no invoice exists yet); `7d`…`12mo` are trailing windows; `custom` uses `from` / `to`. 
   # @option opts [Date] :from Inclusive start (UTC date). Required when `range=custom`.
   # @option opts [Date] :to Inclusive end (UTC date). Required when `range=custom`. Max span 366 days.
   # @option opts [String] :granularity Bucketing of the `days` series: `day` (one row per UTC day), `month` (one row per calendar month, dated to the 1st), or `total` (no series — read `totals`). Does not affect `totals`. 
+  # @option opts [String] :group_by Metering mode. Adds `attribution`: the window's spend split per profile or per account (keys are ids; resolve names via `GET /v1/profiles` / `GET /v1/accounts`).
+  # @option opts [String] :profile_id Metering mode (pair with `range`). Project the payload onto this profile's attributed share. Mutually exclusive with `accountId`, and `groupBy` (if given) must be `profile`; 404 when the profile is not in your workspace (or outside a scoped key's profiles).
+  # @option opts [String] :account_id Metering mode (pair with `range`). Project the payload onto this account's attributed share. Mutually exclusive with `profileId`, and `groupBy` (if given) must be `account`; 404 when the account is not visible to the caller.
   # @return [GetUsage200Response]
   describe 'get_usage test' do
     it 'should work' do

data/spec/models/create_phone_number_stock_watch_request_spec.rb

@@ -0,0 +1,36 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+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 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::CreatePhoneNumberStockWatchRequest
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::CreatePhoneNumberStockWatchRequest do
+  #let(:instance) { Zernio::CreatePhoneNumberStockWatchRequest.new }
+
+  describe 'test an instance of CreatePhoneNumberStockWatchRequest' do
+    it 'should create an instance of CreatePhoneNumberStockWatchRequest' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::CreatePhoneNumberStockWatchRequest)
+    end
+  end
+
+  describe 'test attribute "country"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/create_webhook_settings_request_spec.rb

@@ -48,7 +48,7 @@ describe Zernio::CreateWebhookSettingsRequest do
   describe 'test attribute "events"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('Array<String>', ["post.scheduled", "post.published", "post.failed", "post.partial", "post.cancelled", "post.recycled", "post.platform.published", "post.platform.failed", "post.platform.deleted", "post.tiktok.url_resolved", "post.external.created", "post.external.updated", "post.external.deleted", "account.connected", "account.disconnected", "account.ads.initial_sync_completed", "message.received", "conversation.started", "call.received", "call.ended", "call.failed", "call.permission_request", "message.sent", "message.edited", "message.deleted", "message.delivered", "message.read", "message.failed", "reaction.received", "referral.received", "comment.received", "review.new", "review.updated", "lead.received", "ad.status_changed", "whatsapp.template.status_updated", "whatsapp.template.category_updated", "whatsapp.account.name_status_updated", "whatsapp.automatic_event", "whatsapp.number.activated", "whatsapp.number.declined", "whatsapp.number.action_required", "whatsapp.number.verification_required", "whatsapp.number.suspended", "whatsapp.number.reactivated", "whatsapp.number.released", "whatsapp.number.kyc_submitted", "verification.approved", "verification.failed"])
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('Array<String>', ["post.scheduled", "post.published", "post.failed", "post.partial", "post.cancelled", "post.recycled", "post.platform.published", "post.platform.failed", "post.platform.deleted", "post.tiktok.url_resolved", "post.external.created", "post.external.updated", "post.external.deleted", "account.connected", "account.disconnected", "account.ads.initial_sync_completed", "message.received", "conversation.started", "call.received", "call.ended", "call.failed", "call.permission_request", "message.sent", "message.edited", "message.deleted", "message.delivered", "message.read", "message.failed", "reaction.received", "referral.received", "comment.received", "review.new", "review.updated", "lead.received", "ad.status_changed", "whatsapp.template.status_updated", "whatsapp.template.category_updated", "whatsapp.account.name_status_updated", "whatsapp.automatic_event", "whatsapp.number.activated", "whatsapp.number.declined", "whatsapp.number.action_required", "whatsapp.number.verification_required", "whatsapp.number.suspended", "whatsapp.number.reactivated", "whatsapp.number.released", "whatsapp.number.kyc_submitted", "phone_number.stock_available", "verification.approved", "verification.failed"])
       # validator.allowable_values.each do |value|
       #   expect { instance.events = value }.not_to raise_error
       # end

data/spec/models/list_phone_number_stock_watches200_response_spec.rb

@@ -0,0 +1,36 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+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 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListPhoneNumberStockWatches200Response
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListPhoneNumberStockWatches200Response do
+  #let(:instance) { Zernio::ListPhoneNumberStockWatches200Response.new }
+
+  describe 'test an instance of ListPhoneNumberStockWatches200Response' do
+    it 'should create an instance of ListPhoneNumberStockWatches200Response' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListPhoneNumberStockWatches200Response)
+    end
+  end
+
+  describe 'test attribute "watches"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/phone_number_stock_watch_spec.rb

@@ -0,0 +1,54 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+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 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::PhoneNumberStockWatch
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::PhoneNumberStockWatch do
+  #let(:instance) { Zernio::PhoneNumberStockWatch.new }
+
+  describe 'test an instance of PhoneNumberStockWatch' do
+    it 'should create an instance of PhoneNumberStockWatch' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::PhoneNumberStockWatch)
+    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 "country"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "country_name"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "created_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/update_webhook_settings_request_spec.rb

@@ -54,7 +54,7 @@ describe Zernio::UpdateWebhookSettingsRequest do
   describe 'test attribute "events"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('Array<String>', ["post.scheduled", "post.published", "post.failed", "post.partial", "post.cancelled", "post.recycled", "post.platform.published", "post.platform.failed", "post.platform.deleted", "post.tiktok.url_resolved", "post.external.created", "post.external.updated", "post.external.deleted", "account.connected", "account.disconnected", "account.ads.initial_sync_completed", "message.received", "conversation.started", "call.received", "call.ended", "call.failed", "call.permission_request", "message.sent", "message.edited", "message.deleted", "message.delivered", "message.read", "message.failed", "reaction.received", "referral.received", "comment.received", "review.new", "review.updated", "lead.received", "ad.status_changed", "whatsapp.template.status_updated", "whatsapp.template.category_updated", "whatsapp.account.name_status_updated", "whatsapp.automatic_event", "whatsapp.number.activated", "whatsapp.number.declined", "whatsapp.number.action_required", "whatsapp.number.verification_required", "whatsapp.number.suspended", "whatsapp.number.reactivated", "whatsapp.number.released", "whatsapp.number.kyc_submitted", "verification.approved", "verification.failed"])
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('Array<String>', ["post.scheduled", "post.published", "post.failed", "post.partial", "post.cancelled", "post.recycled", "post.platform.published", "post.platform.failed", "post.platform.deleted", "post.tiktok.url_resolved", "post.external.created", "post.external.updated", "post.external.deleted", "account.connected", "account.disconnected", "account.ads.initial_sync_completed", "message.received", "conversation.started", "call.received", "call.ended", "call.failed", "call.permission_request", "message.sent", "message.edited", "message.deleted", "message.delivered", "message.read", "message.failed", "reaction.received", "referral.received", "comment.received", "review.new", "review.updated", "lead.received", "ad.status_changed", "whatsapp.template.status_updated", "whatsapp.template.category_updated", "whatsapp.account.name_status_updated", "whatsapp.automatic_event", "whatsapp.number.activated", "whatsapp.number.declined", "whatsapp.number.action_required", "whatsapp.number.verification_required", "whatsapp.number.suspended", "whatsapp.number.reactivated", "whatsapp.number.released", "whatsapp.number.kyc_submitted", "phone_number.stock_available", "verification.approved", "verification.failed"])
       # validator.allowable_values.each do |value|
       #   expect { instance.events = value }.not_to raise_error
       # end