late-sdk 0.0.571 → 0.0.573

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

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

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -218,6 +218,7 @@ require 'zernio-sdk/models/create_invite_token201_response'
 require 'zernio-sdk/models/create_invite_token_request'
 require 'zernio-sdk/models/create_lead_form200_response'
 require 'zernio-sdk/models/create_lead_form_request'
+require 'zernio-sdk/models/create_lead_form_request_platform_specific_data'
 require 'zernio-sdk/models/create_lead_form_request_questions_inner'
 require 'zernio-sdk/models/create_messaging_ad_request'
 require 'zernio-sdk/models/create_phone_number_kyc_link200_response'
@@ -781,6 +782,13 @@ require 'zernio-sdk/models/linked_in_aggregate_analytics_daily_response_analytic
 require 'zernio-sdk/models/linked_in_aggregate_analytics_daily_response_analytics_impressions_inner'
 require 'zernio-sdk/models/linked_in_aggregate_analytics_total_response'
 require 'zernio-sdk/models/linked_in_aggregate_analytics_total_response_analytics'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_consents_inner'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_locale'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_questions_inner'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_questions_inner_one_of'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_questions_inner_one_of1'
+require 'zernio-sdk/models/linked_in_lead_form_platform_data_questions_inner_one_of1_choices_inner'
 require 'zernio-sdk/models/linked_in_platform_data'
 require 'zernio-sdk/models/list_account_groups200_response'
 require 'zernio-sdk/models/list_account_groups200_response_groups_inner'
@@ -940,6 +948,8 @@ require 'zernio-sdk/models/lookup_sms_number200_response'
 require 'zernio-sdk/models/mark_conversation_read200_response'
 require 'zernio-sdk/models/media_item'
 require 'zernio-sdk/models/media_upload_response'
+require 'zernio-sdk/models/meta_lead_form_platform_data'
+require 'zernio-sdk/models/meta_lead_form_platform_data_context_card'
 require 'zernio-sdk/models/money'
 require 'zernio-sdk/models/money_amount'
 require 'zernio-sdk/models/move_account_to_profile200_response'

data/openapi.yaml

@@ -28166,16 +28166,20 @@ paths:
                     type: array
                     description: >
                       Live inventory grouped by area code, largest stock
-                      first. Empty when out of stock (or the area lookup
-                      failed). Pass a chosen `ndc` as `areaCode` on POST
+                      first. For US and CA this is the full country inventory
+                      (every area code with stock, named by state/province);
+                      other countries list the areas in the latest inventory
+                      page (up to 500 numbers, which for most countries is the
+                      entire pool). Empty when out of stock (or the area
+                      lookup failed). Pass a chosen `ndc` as `areaCode` on POST
                       /v1/phone-numbers/purchase (or on the KYC submit for
                       regulated countries) to require that area.
                     items:
                       type: object
                       properties:
                         ndc: { type: string, description: 'Area code (national destination code), e.g. "11".' }
-                        name: { type: string, description: 'Human-readable area name, e.g. "Sao Paulo".' }
-                        count: { type: integer, description: Deliverable numbers seen in this area on the latest inventory page. }
+                        name: { type: string, description: 'Area name: state/province for US/CA (e.g. "Minnesota"), city otherwise (e.g. "Sao Paulo").' }
+                        count: { type: integer, description: 'Numbers available in this area: country-wide count for US/CA, numbers seen on the latest inventory page otherwise.' }
         '400': { description: Country not offerable }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
@@ -28532,16 +28536,20 @@ paths:
                     type: array
                     description: >
                       Live inventory grouped by area code, largest stock
-                      first. Empty when out of stock (or the area lookup
-                      failed). Pass a chosen `ndc` as `areaCode` on POST
+                      first. For US and CA this is the full country inventory
+                      (every area code with stock, named by state/province);
+                      other countries list the areas in the latest inventory
+                      page (up to 500 numbers, which for most countries is the
+                      entire pool). Empty when out of stock (or the area
+                      lookup failed). Pass a chosen `ndc` as `areaCode` on POST
                       /v1/phone-numbers/purchase (or on the KYC submit for
                       regulated countries) to require that area.
                     items:
                       type: object
                       properties:
                         ndc: { type: string, description: 'Area code (national destination code), e.g. "11".' }
-                        name: { type: string, description: 'Human-readable area name, e.g. "Sao Paulo".' }
-                        count: { type: integer, description: Deliverable numbers seen in this area on the latest inventory page. }
+                        name: { type: string, description: 'Area name: state/province for US/CA (e.g. "Minnesota"), city otherwise (e.g. "Sao Paulo").' }
+                        count: { type: integer, description: 'Numbers available in this area: country-wide count for US/CA, numbers seen on the latest inventory page otherwise.' }
         '400': { description: Country not offerable }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
@@ -37146,18 +37154,25 @@ paths:
     get:
       operationId: listLeads
       tags: ["Lead Gen"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "linkedin"]
       summary: List submitted leads
       description: >
-        Returns persisted Meta Lead Gen leads for your team, newest-first, with
-        keyset pagination on `cursor`. Leads are ingested in real time from the
-        `leadgen` webhook. Requires the Ads add-on.
+        Returns submitted Lead Gen leads for your team, newest-first, with
+        keyset pagination on `cursor`. For Meta (default) leads are served from
+        the persisted cache, ingested in real time from the `leadgen` webhook.
+        When `accountId` is a LinkedIn ads account, leads are fetched live from
+        LinkedIn's `leadFormResponses` (LinkedIn has no webhook and enforces
+        90-day retention, so nothing is persisted) and `adAccountId` is required.
+        Reading LinkedIn responses needs the `r_marketing_leadgen_automation`
+        permission; accounts connected before it was added must reconnect.
+        Requires the Ads add-on.
       parameters:
         - { name: formId, in: query, schema: { type: string }, description: Filter to a single lead form. }
-        - { name: accountId, in: query, schema: { type: string }, description: Filter to a single connected account. }
+        - { name: accountId, in: query, schema: { type: string }, description: Filter to a single connected account. LinkedIn ads accounts switch to the live fetch. }
+        - { name: adAccountId, in: query, schema: { type: string }, description: "LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder)." }
         - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 } }
-        - { name: since, in: query, schema: { type: integer }, description: Unix seconds; only leads created at/after this Meta timestamp. }
-        - { name: cursor, in: query, schema: { type: string }, description: Keyset cursor from a previous response's pagination.cursor. }
+        - { name: since, in: query, schema: { type: integer }, description: Unix seconds; only leads created at/after this timestamp. }
+        - { name: cursor, in: query, schema: { type: string }, description: "Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset)." }
       responses:
         '200':
           description: Lead list.
@@ -37196,11 +37211,16 @@ paths:
     get:
       operationId: listLeadForms
       tags: ["Lead Gen"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "linkedin"]
       summary: List lead forms
-      description: Lists the Lead Gen forms owned by the connected Facebook Page. Requires the Ads add-on.
+      description: >
+        Lists the Lead Gen forms owned by the account. Meta: forms on the
+        connected Facebook Page. LinkedIn: forms owned by the ad account's
+        Company Page — pass `adAccountId` (LinkedIn forms are org-owned).
+        Requires the Ads add-on.
       parameters:
-        - { name: accountId, in: query, required: true, schema: { type: string }, description: Connected facebook account id. }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: Connected facebook or linkedin ads account id. }
+        - { name: adAccountId, in: query, schema: { type: string }, description: "LinkedIn only: the LinkedIn ad account id (used to resolve the owning organization). Required for LinkedIn." }
         - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 } }
         - { name: cursor, in: query, schema: { type: string } }
       responses:
@@ -37219,26 +37239,36 @@ paths:
     post:
       operationId: createLeadForm
       tags: ["Lead Gen"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "linkedin"]
       summary: Create a lead form
       description: >
-        Creates a Lead Gen form on the connected Facebook Page (POST
-        /{page-id}/leadgen_forms). NOT idempotent — a retry creates a second
-        form. Prefilled question types (EMAIL, PHONE, FULL_NAME, …) must omit
-        label/key; CUSTOM questions require both. Requires the Ads add-on.
+        Creates a Lead Gen form. The form content goes inside
+        `platformSpecificData` for both platforms (the shape is selected by the
+        accountId's platform). Meta: created on the connected Facebook Page
+        (POST /{page-id}/leadgen_forms); the old top-level Meta fields
+        (questions, thankYou*, contextCard, …) are DEPRECATED but still
+        accepted while platformSpecificData is absent — mixing both shapes is
+        a 400. LinkedIn: created on the ad account's Company Page. NOT
+        idempotent — a retry creates a second form. Meta prefilled question
+        types (EMAIL, PHONE, FULL_NAME, …) must omit label/key; CUSTOM
+        questions require both. LinkedIn exposes only free-text and
+        multiple-choice questions via API (prefilled-from-profile fields are
+        Campaign Manager UI-only). Requires the Ads add-on.
       requestBody:
         required: true
         content:
           application/json:
             schema:
               type: object
-              required: [accountId, name, questions, privacyPolicyUrl]
+              required: [accountId, name, privacyPolicyUrl]
               properties:
                 accountId: { type: string }
                 name: { type: string, maxLength: 200 }
                 questions:
                   type: array
                   minItems: 1
+                  deprecated: true
+                  description: "Deprecated (Meta legacy shape): use platformSpecificData.questions."
                   items:
                     type: object
                     required: [type]
@@ -37249,15 +37279,103 @@ paths:
                       options: { type: array, items: { type: object, properties: { key: { type: string }, value: { type: string } } } }
                       inline_context: { type: string }
                 privacyPolicyUrl: { type: string, format: uri }
-                privacyPolicyLinkText: { type: string, maxLength: 70 }
-                followUpActionUrl: { type: string, format: uri }
-                locale: { type: string, example: EN_US }
-                thankYouTitle: { type: string }
-                thankYouBody: { type: string }
-                thankYouButtonText: { type: string }
-                thankYouButtonType: { type: string, example: VIEW_WEBSITE }
-                thankYouWebsiteUrl: { type: string, format: uri }
-                isOptimizedForQuality: { type: boolean }
+                privacyPolicyLinkText: { type: string, maxLength: 70, deprecated: true, description: "Deprecated: use platformSpecificData.privacyPolicyLinkText." }
+                followUpActionUrl: { type: string, format: uri, deprecated: true, description: "Deprecated: use platformSpecificData.followUpActionUrl." }
+                locale: { type: string, example: EN_US, deprecated: true, description: "Deprecated: use platformSpecificData.locale." }
+                thankYouTitle: { type: string, deprecated: true, description: "Deprecated: use platformSpecificData.thankYouTitle." }
+                thankYouBody: { type: string, deprecated: true, description: "Deprecated: use platformSpecificData.thankYouBody." }
+                thankYouButtonText: { type: string, deprecated: true, description: "Deprecated: use platformSpecificData.thankYouButtonText." }
+                thankYouButtonType: { type: string, example: VIEW_WEBSITE, deprecated: true, description: "Deprecated: use platformSpecificData.thankYouButtonType." }
+                thankYouWebsiteUrl: { type: string, format: uri, deprecated: true, description: "Deprecated: use platformSpecificData.thankYouWebsiteUrl." }
+                isOptimizedForQuality: { type: boolean, deprecated: true, description: "Deprecated: use platformSpecificData.isOptimizedForQuality." }
+                platformSpecificData:
+                  description: "Form content; the shape is selected by the accountId's platform. Unknown fields are a 400 (strict-parsed)."
+                  oneOf:
+                    - type: object
+                      title: MetaLeadFormPlatformData
+                      required: [questions]
+                      properties:
+                        questions:
+                          type: array
+                          minItems: 1
+                          items:
+                            type: object
+                            required: [type]
+                            properties:
+                              type: { type: string, description: "EMAIL, PHONE, FULL_NAME, FIRST_NAME, LAST_NAME, CUSTOM, …" }
+                              key: { type: string, description: "CUSTOM questions only." }
+                              label: { type: string, description: "CUSTOM questions only." }
+                              options: { type: array, items: { type: object, properties: { key: { type: string }, value: { type: string } } } }
+                              inline_context: { type: string }
+                        privacyPolicyLinkText: { type: string, maxLength: 70 }
+                        followUpActionUrl: { type: string, format: uri }
+                        locale: { type: string, example: EN_US }
+                        thankYouTitle: { type: string }
+                        thankYouBody: { type: string }
+                        thankYouButtonText: { type: string }
+                        thankYouButtonType: { type: string, example: VIEW_WEBSITE }
+                        thankYouWebsiteUrl: { type: string, format: uri }
+                        isOptimizedForQuality: { type: boolean }
+                        formType: { type: string, enum: [MORE_VOLUME, HIGHER_INTENT, RICH_CREATIVE] }
+                        blockDisplayForNonTargetedViewer: { type: boolean }
+                        allowOrganicLeadGen: { type: boolean }
+                        questionPageCustomHeadline: { type: string }
+                        contextCard:
+                          type: object
+                          properties:
+                            title: { type: string }
+                            content: { type: array, items: { type: string } }
+                            style: { type: string, enum: [LIST_STYLE, PARAGRAPH_STYLE] }
+                            buttonText: { type: string }
+                            coverPhoto: { type: string }
+                    - type: object
+                      title: LinkedInLeadFormPlatformData
+                      required: [adAccountId, headline, description, questions]
+                      properties:
+                        adAccountId: { type: string, description: "LinkedIn ad account id (resolves the owning organization)." }
+                        headline: { type: string, maxLength: 255 }
+                        description: { type: string, maxLength: 1500 }
+                        state: { type: string, enum: [DRAFT, PUBLISHED], description: "Defaults to DRAFT." }
+                        locale: { type: object, properties: { country: { type: string }, language: { type: string } } }
+                        consents:
+                          type: array
+                          items:
+                            type: object
+                            required: [description]
+                            properties:
+                              description: { type: string }
+                              required: { type: boolean, description: "Whether the viewer must tick this consent to submit. Defaults to false.", default: false }
+                        questions:
+                          type: array
+                          minItems: 1
+                          items:
+                            oneOf:
+                              - type: object
+                                required: [kind, name, question]
+                                properties:
+                                  kind: { type: string, enum: [text] }
+                                  name: { type: string }
+                                  question: { type: string }
+                                  required: { type: boolean }
+                                  responseEditable: { type: boolean }
+                                  maxResponseLength: { type: integer, description: "Defaults to 300 on LinkedIn's side." }
+                              - type: object
+                                required: [kind, name, question, choices]
+                                properties:
+                                  kind: { type: string, enum: [multipleChoice] }
+                                  name: { type: string }
+                                  question: { type: string }
+                                  required: { type: boolean }
+                                  responseEditable: { type: boolean }
+                                  choices:
+                                    type: array
+                                    minItems: 1
+                                    items:
+                                      type: object
+                                      required: [id, text]
+                                      properties:
+                                        id: { type: integer }
+                                        text: { type: string }
       responses:
         '200':
           description: Created form.
@@ -37275,11 +37393,11 @@ paths:
     get:
       operationId: getLeadForm
       tags: ["Lead Gen"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "linkedin"]
       summary: Get a lead form
       parameters:
-        - { name: formId, in: path, required: true, schema: { type: string } }
-        - { name: accountId, in: query, required: true, schema: { type: string } }
+        - { name: formId, in: path, required: true, schema: { type: string }, description: "Numeric form id (Meta leadgen_form id or LinkedIn leadForm id)." }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Connected facebook or linkedin ads account id (selects the platform)." }
       responses:
         '200':
           description: Form metadata.
@@ -37290,12 +37408,12 @@ paths:
     delete:
       operationId: archiveLeadForm
       tags: ["Lead Gen"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "linkedin"]
       summary: Archive a lead form
-      description: Meta has no hard delete for forms; this archives the form (status=ARCHIVED).
+      description: "Neither platform hard-deletes a form; this archives it (Meta status=ARCHIVED; LinkedIn state=ARCHIVED via PARTIAL_UPDATE)."
       parameters:
-        - { name: formId, in: path, required: true, schema: { type: string } }
-        - { name: accountId, in: query, required: true, schema: { type: string } }
+        - { name: formId, in: path, required: true, schema: { type: string }, description: "Numeric form id (Meta leadgen_form id or LinkedIn leadForm id)." }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Connected facebook or linkedin ads account id (selects the platform)." }
       responses:
         '200':
           description: Archived.

data/spec/api/lead_gen_api_spec.rb

@@ -34,9 +34,9 @@ describe 'LeadGenApi' do
 
   # unit tests for archive_lead_form
   # Archive a lead form
-  # Meta has no hard delete for forms; this archives the form (status=ARCHIVED).
-  # @param form_id 
-  # @param account_id 
+  # Neither platform hard-deletes a form; this archives it (Meta status=ARCHIVED; LinkedIn state=ARCHIVED via PARTIAL_UPDATE).
+  # @param form_id Numeric form id (Meta leadgen_form id or LinkedIn leadForm id).
+  # @param account_id Connected facebook or linkedin ads account id (selects the platform).
   # @param [Hash] opts the optional parameters
   # @return [ArchiveLeadForm200Response]
   describe 'archive_lead_form test' do
@@ -47,7 +47,7 @@ describe 'LeadGenApi' do
 
   # unit tests for create_lead_form
   # Create a lead form
-  # Creates a Lead Gen form on the connected Facebook Page (POST /{page-id}/leadgen_forms). NOT idempotent — a retry creates a second form. Prefilled question types (EMAIL, PHONE, FULL_NAME, …) must omit label/key; CUSTOM questions require both. Requires the Ads add-on. 
+  # Creates a Lead Gen form. The form content goes inside `platformSpecificData` for both platforms (the shape is selected by the accountId's platform). Meta: created on the connected Facebook Page (POST /{page-id}/leadgen_forms); the old top-level Meta fields (questions, thankYou*, contextCard, …) are DEPRECATED but still accepted while platformSpecificData is absent — mixing both shapes is a 400. LinkedIn: created on the ad account's Company Page. NOT idempotent — a retry creates a second form. Meta prefilled question types (EMAIL, PHONE, FULL_NAME, …) must omit label/key; CUSTOM questions require both. LinkedIn exposes only free-text and multiple-choice questions via API (prefilled-from-profile fields are Campaign Manager UI-only). Requires the Ads add-on. 
   # @param create_lead_form_request 
   # @param [Hash] opts the optional parameters
   # @return [CreateLeadForm200Response]
@@ -72,8 +72,8 @@ describe 'LeadGenApi' do
 
   # unit tests for get_lead_form
   # Get a lead form
-  # @param form_id 
-  # @param account_id 
+  # @param form_id Numeric form id (Meta leadgen_form id or LinkedIn leadForm id).
+  # @param account_id Connected facebook or linkedin ads account id (selects the platform).
   # @param [Hash] opts the optional parameters
   # @return [GetLeadForm200Response]
   describe 'get_lead_form test' do
@@ -100,9 +100,10 @@ describe 'LeadGenApi' do
 
   # unit tests for list_lead_forms
   # List lead forms
-  # Lists the Lead Gen forms owned by the connected Facebook Page. Requires the Ads add-on.
-  # @param account_id Connected facebook account id.
+  # Lists the Lead Gen forms owned by the account. Meta: forms on the connected Facebook Page. LinkedIn: forms owned by the ad account's Company Page — pass `adAccountId` (LinkedIn forms are org-owned). Requires the Ads add-on. 
+  # @param account_id Connected facebook or linkedin ads account id.
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :ad_account_id LinkedIn only: the LinkedIn ad account id (used to resolve the owning organization). Required for LinkedIn.
   # @option opts [Integer] :limit 
   # @option opts [String] :cursor 
   # @return [ListLeadForms200Response]
@@ -114,13 +115,14 @@ describe 'LeadGenApi' do
 
   # unit tests for list_leads
   # List submitted leads
-  # Returns persisted Meta Lead Gen leads for your team, newest-first, with keyset pagination on `cursor`. Leads are ingested in real time from the `leadgen` webhook. Requires the Ads add-on. 
+  # Returns submitted Lead Gen leads for your team, newest-first, with keyset pagination on `cursor`. For Meta (default) leads are served from the persisted cache, ingested in real time from the `leadgen` webhook. When `accountId` is a LinkedIn ads account, leads are fetched live from LinkedIn's `leadFormResponses` (LinkedIn has no webhook and enforces 90-day retention, so nothing is persisted) and `adAccountId` is required. Reading LinkedIn responses needs the `r_marketing_leadgen_automation` permission; accounts connected before it was added must reconnect. Requires the Ads add-on. 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :form_id Filter to a single lead form.
-  # @option opts [String] :account_id Filter to a single connected account.
+  # @option opts [String] :account_id Filter to a single connected account. LinkedIn ads accounts switch to the live fetch.
+  # @option opts [String] :ad_account_id LinkedIn only: the LinkedIn ad account id whose responses to read (owner-scoped finder).
   # @option opts [Integer] :limit 
-  # @option opts [Integer] :since Unix seconds; only leads created at/after this Meta timestamp.
-  # @option opts [String] :cursor Keyset cursor from a previous response's pagination.cursor.
+  # @option opts [Integer] :since Unix seconds; only leads created at/after this timestamp.
+  # @option opts [String] :cursor Keyset cursor from a previous response's pagination.cursor (Meta: AdLead id; LinkedIn: numeric start offset).
   # @return [ListLeads200Response]
   describe 'list_leads test' do
     it 'should work' do

data/spec/models/create_lead_form_request_platform_specific_data_spec.rb

@@ -0,0 +1,32 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::CreateLeadFormRequestPlatformSpecificData
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::CreateLeadFormRequestPlatformSpecificData do
+  describe '.openapi_one_of' do
+    it 'lists the items referenced in the oneOf array' do
+      expect(described_class.openapi_one_of).to_not be_empty
+    end
+  end
+
+  describe '.build' do
+    it 'returns the correct model' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+end