late-sdk 0.0.536 → 0.0.538

data/openapi.yaml

@@ -33030,6 +33030,54 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+    post:
+      operationId: createAdCampaign
+      tags: [Ad Campaigns]
+      summary: Create a standalone campaign (Meta)
+      description: |-
+        Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it
+        later via `existingCampaignId` on the create endpoints. A budget here is campaign-level
+        (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
+        `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
+        next sync discovery pass. Meta only.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, adAccountId, name, goal]
+              properties:
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                name: { type: string, maxLength: 255 }
+                goal:
+                  type: string
+                  enum: [engagement, traffic, awareness, video_views, lead_generation, lead_conversion, job_applicants, conversions, app_promotion, catalog_sales]
+                  description: Mapped to the ODAX objective (same mapping as POST /v1/ads/create).
+                specialAdCategories:
+                  type: array
+                  items: { type: string, enum: [HOUSING, EMPLOYMENT, CREDIT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCTS_SERVICES, ONLINE_GAMBLING_AND_GAMING] }
+                budgetAmount: { type: number, description: "Campaign-level (CBO) budget in whole currency units. Requires budgetType." }
+                budgetType: { type: string, enum: [daily, lifetime] }
+                status: { type: string, enum: [ACTIVE, PAUSED], default: PAUSED }
+      responses:
+        '201':
+          description: Campaign created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  campaignId: { type: string, description: Platform id of the new campaign }
+                  objective: { type: string, description: "Resolved ODAX objective (e.g. OUTCOME_SALES)." }
+                  status: { type: string, enum: [ACTIVE, PAUSED] }
+        '400': { description: "Invalid input, or Meta rejected the create" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
 
   /v1/ads/campaigns/{campaignId}/status:
     put:
@@ -33318,6 +33366,98 @@ paths:
         '404': { description: Source campaign not found }
         '501': { description: Operation not supported on this platform }
 
+  /v1/ads/ad-sets/{adSetId}/duplicate:
+    post:
+      operationId: duplicateAdSet
+      tags: [Ad Campaigns]
+      summary: Duplicate an ad set (Meta)
+      description: |-
+        Duplicates an ad set, including its ads and creatives by default (`deepCopy: true`),
+        via Meta's native `POST /{adset-id}/copies`. The copy is created paused so callers can
+        review before launching. `campaignId` retargets the copy into another campaign; omitted
+        = the source's own campaign. The new hierarchy materializes asynchronously — sync
+        discovery is triggered automatically (`syncAfter: false` to skip). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: adSetId, in: path, required: true, schema: { type: string }, description: Source platform ad set ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [platform]
+              properties:
+                platform: { type: string, enum: [facebook, instagram] }
+                campaignId: { type: string, description: Destination platform campaign id (defaults to the source's campaign) }
+                deepCopy: { type: boolean, default: true, description: Copy child ads + creatives }
+                statusOption: { type: string, enum: [ACTIVE, PAUSED, INHERITED_FROM_SOURCE], default: PAUSED }
+                startTime: { type: string, format: date-time, description: Reschedule the copy's start time }
+                endTime: { type: string, format: date-time }
+                renameStrategy: { type: string, enum: [DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME] }
+                renamePrefix: { type: string }
+                renameSuffix: { type: string }
+                syncAfter: { type: boolean, default: true }
+      responses:
+        '200':
+          description: Ad set duplicated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  copiedAdSetId: { type: string, description: Platform ID of the new ad set }
+                  discovery: { type: string, enum: [triggered, skipped, failed] }
+                  raw: { type: object, description: Meta's native copy response (includes ad_object_ids for child copies) }
+        '400': { description: Invalid input }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Source ad set not found }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
+  /v1/ads/{adId}/duplicate:
+    post:
+      operationId: duplicateAd
+      tags: [Ads]
+      summary: Duplicate an ad (Meta)
+      description: |-
+        Duplicates a single ad via Meta's native `POST /{ad-id}/copies`. The copy is created
+        paused. `adSetId` retargets the copy into another ad set; omitted = the source's own ad
+        set. Accepts the Zernio ad id or the platform ad id. Sync discovery is triggered
+        automatically (`syncAfter: false` to skip). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: adId, in: path, required: true, schema: { type: string }, description: Zernio ad ID or platform ad ID }
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                adSetId: { type: string, description: Destination platform ad set id (defaults to the source's ad set) }
+                statusOption: { type: string, enum: [ACTIVE, PAUSED, INHERITED_FROM_SOURCE], default: PAUSED }
+                renameStrategy: { type: string, enum: [DEEP_RENAME, ONLY_TOP_LEVEL_RENAME, NO_RENAME] }
+                renamePrefix: { type: string }
+                renameSuffix: { type: string }
+                syncAfter: { type: boolean, default: true }
+      responses:
+        '200':
+          description: Ad duplicated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  copiedAdId: { type: string, description: Platform ID of the new ad }
+                  discovery: { type: string, enum: [triggered, skipped, failed] }
+                  raw: { type: object }
+        '400': { description: Invalid input }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Ad not found }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
   /v1/ads/ad-sets/{adSetId}:
     get:
       operationId: getAdSetDetails
@@ -34640,6 +34780,263 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
+  /v1/ads/labels:
+    get:
+      operationId: listAdLabels
+      tags: [Ads]
+      summary: Ad labels (Meta)
+      description: |-
+        Lists the ad account's organizational labels (Meta's `/act_X/adlabels`), rows returned
+        verbatim (id, name, created/updated time). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+        - { name: adAccountId, in: query, required: true, schema: { type: string }, description: "Meta ad account id (act_<n>)." }
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 }, description: Rows per page }
+        - { name: after, in: query, schema: { type: string }, description: "Cursor from paging.after of the previous page." }
+      responses:
+        '200':
+          description: Ad labels (raw Meta shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw Meta ad label row (id, name, created_time, updated_time)." }
+                  paging:
+                    type: object
+                    properties:
+                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or Meta rejected the query" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
+  /v1/ads/high-demand-periods:
+    get:
+      operationId: listHighDemandPeriods
+      tags: [Ads]
+      summary: High demand periods / budget schedules (Meta)
+      description: |-
+        Scheduled budget increases (Meta's budget-scheduling API). The Graph edge lives on the
+        campaign and ad-set nodes only, so exactly one of `campaignId` / `adSetId` (platform
+        ids) is required. Rows returned verbatim (budget_value, budget_value_type, time window,
+        recurrence). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+        - { name: campaignId, in: query, schema: { type: string }, description: "Platform campaign id. Exactly one of campaignId / adSetId." }
+        - { name: adSetId, in: query, schema: { type: string }, description: "Platform ad set id. Exactly one of campaignId / adSetId." }
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 }, description: Rows per page }
+        - { name: after, in: query, schema: { type: string }, description: "Cursor from paging.after of the previous page." }
+      responses:
+        '200':
+          description: Budget schedules (raw Meta shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  objectId: { type: string, description: "The campaign / ad set id the schedules belong to." }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw Meta high-demand-period row." }
+                  paging:
+                    type: object
+                    properties:
+                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or Meta rejected the query" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
+  /v1/ads/creatives:
+    get:
+      operationId: listAdCreatives
+      tags: [Ads]
+      summary: Creative library (Meta)
+      description: |-
+        Lists the ad account's creative library (Meta's `/act_X/adcreatives`), rows returned
+        verbatim. The default projection covers id, name, status, object type, thumbnail,
+        object_story_spec / asset_feed_spec and url_tags; `fields` is a raw-passthrough
+        override. Any creative id here is reusable on the create endpoints via
+        `existingCreativeId`. Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+        - { name: adAccountId, in: query, required: true, schema: { type: string }, description: "Meta ad account id (act_<n>)." }
+        - { name: fields, in: query, schema: { type: string }, description: "Comma-separated Graph field override (supports nested {} projections)." }
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 }, description: Rows per page }
+        - { name: after, in: query, schema: { type: string }, description: "Cursor from paging.after of the previous page." }
+      responses:
+        '200':
+          description: Creatives (raw Meta shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw Meta creative row." }
+                  paging:
+                    type: object
+                    properties:
+                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or Meta rejected the query" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+    post:
+      operationId: createAdCreative
+      tags: [Ads]
+      summary: Create a standalone creative (Meta)
+      description: |-
+        Creates a creative in the library WITHOUT an ad, reusable on the create endpoints via
+        `existingCreativeId`. Provide exactly one of `imageUrl` (uploaded server-side),
+        `imageHash` (from POST /v1/ads/images or the library list), or `carouselCards` (2-10
+        hand-built cards). The Page (and linked Instagram account, when present) is resolved
+        from `accountId` as the story actor. Meta only.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, adAccountId, headline, body, linkUrl]
+              properties:
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page." }
+                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                headline: { type: string, maxLength: 255 }
+                body: { type: string, description: Primary text }
+                description: { type: string, maxLength: 255, description: "Link description below the headline; omitted = Meta scrapes the destination's OG description." }
+                callToAction: { type: string, default: LEARN_MORE, description: "CTA type (same whitelist as POST /v1/ads/create)." }
+                linkUrl: { type: string, format: uri }
+                imageUrl: { type: string, format: uri, description: "Publicly reachable image; uploaded to the account's library server-side." }
+                imageHash: { type: string, description: "Existing library image hash (POST /v1/ads/images or GET /v1/ads/images)." }
+                carouselCards:
+                  type: array
+                  minItems: 2
+                  maxItems: 10
+                  items:
+                    type: object
+                    required: [imageUrl, linkUrl]
+                    properties:
+                      imageUrl: { type: string, format: uri }
+                      linkUrl: { type: string, format: uri }
+                      headline: { type: string, maxLength: 255 }
+                      description: { type: string, maxLength: 255 }
+                      callToAction: { type: string }
+                urlTags: { type: string, description: "Appended to every outbound URL (e.g. utm_source=fb)." }
+      responses:
+        '201':
+          description: Creative created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  creativeId: { type: string, description: "Platform creative id, reusable via existingCreativeId." }
+        '400': { description: "Invalid input, or Meta rejected the create" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '422': { description: No Facebook Page found to act as the story actor }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
+  /v1/ads/creatives/{creativeId}:
+    get:
+      operationId: getAdCreative
+      tags: [Ads]
+      summary: Creative details (Meta)
+      description: |-
+        One creative's details, verbatim from Meta. `fields` is a raw-passthrough override of
+        the default projection. Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: creativeId, in: path, required: true, schema: { type: string }, description: Platform creative id }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+        - { name: fields, in: query, schema: { type: string }, description: "Comma-separated Graph field override (supports nested {} projections)." }
+      responses:
+        '200':
+          description: Creative details
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  creative: { type: object, description: Raw Meta creative node }
+        '400': { description: "Invalid input, or Meta rejected the query" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+    put:
+      operationId: updateAdCreative
+      tags: [Ads]
+      summary: Rename a creative (Meta)
+      description: |-
+        Renames a creative. Creatives are immutable on Meta beyond `name` — for content changes
+        create a new creative (POST /v1/ads/creatives) and swap it onto the ad
+        (PUT /v1/ads/{adId} with `creative`). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: creativeId, in: path, required: true, schema: { type: string }, description: Platform creative id }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, name]
+              properties:
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                name: { type: string, maxLength: 255 }
+      responses:
+        '200':
+          description: Creative renamed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  creativeId: { type: string }
+                  name: { type: string }
+                  message: { type: string }
+        '400': { description: "Invalid input, or Meta rejected the update" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+    delete:
+      operationId: deleteAdCreative
+      tags: [Ads]
+      summary: Delete a creative (Meta)
+      description: |-
+        Deletes a creative from the library. Meta only allows deleting creatives not referenced
+        by any ad — otherwise its 400 surfaces verbatim.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: creativeId, in: path, required: true, schema: { type: string }, description: Platform creative id }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+      responses:
+        '200':
+          description: Creative deleted
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  creativeId: { type: string }
+                  message: { type: string }
+        '400': { description: "Invalid input, the creative is in use, or Meta rejected the delete" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
   /v1/ads/accounts/finance:
     get:
       operationId: getAdAccountFinance
@@ -36086,6 +36483,42 @@ paths:
         '400': { description: "Invalid input, or Meta rejected the image" }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '501': { description: Only supported on Meta (facebook/instagram) }
+    get:
+      operationId: listAdImages
+      tags: [Ads]
+      summary: Ad image library (Meta)
+      description: |-
+        Lists the ad account's image library (Meta's `/act_X/adimages`), rows returned verbatim.
+        The default projection covers hash, url, name, dimensions and status; `fields` is a
+        raw-passthrough override. Any `hash` here is reusable wherever Meta accepts
+        `image_hash` (e.g. `imageHash` on POST /v1/ads/creatives). Meta only.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+        - { name: adAccountId, in: query, required: true, schema: { type: string }, description: "Meta ad account id (act_<n>)." }
+        - { name: fields, in: query, schema: { type: string }, description: "Comma-separated Graph field override (supports nested {} projections)." }
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 }, description: Rows per page }
+        - { name: after, in: query, schema: { type: string }, description: "Cursor from paging.after of the previous page." }
+      responses:
+        '200':
+          description: Ad images (raw Meta shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  data:
+                    type: array
+                    items: { type: object, description: "Raw Meta ad image row (hash, url, name, width, height, status)." }
+                  paging:
+                    type: object
+                    properties:
+                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+        '400': { description: "Invalid input, or Meta rejected the query" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '501': { description: Only supported on Meta (facebook/instagram) }
 
   /v1/ads/interests:
     get:
@@ -36657,12 +37090,15 @@ paths:
     put:
       operationId: updateAdAudience
       tags: [Ad Audiences]
-      summary: Update saved targeting audience
+      summary: Update an audience
       description: |
-        Update a `saved_targeting` audience's name, description, or spec. Only `saved_targeting` audiences are
-        updatable (they exist only on Zernio); uploaded/derived audiences return 422, delete and recreate those
-        instead. `spec` replaces the stored spec wholesale (no merge). Ads already created from this audience are
-        unaffected, they snapshot the targeting at creation.
+        Update an audience. `saved_targeting` audiences accept `name`, `description`, and `spec`
+        (full replacement, no merge, Zernio-only, no platform call). Platform audiences
+        (uploaded/website/lookalike) accept `name` and `description` only, updated on the
+        platform first and then mirrored locally; their rules are immutable, so `spec` returns
+        400 for them. Platform audience updates are Meta-only for now (other platforms return
+        501). Ads already created from a saved_targeting audience are unaffected, they snapshot
+        the targeting at creation.
       security:
         - bearerAuth: []
       parameters:
@@ -36691,13 +37127,15 @@ paths:
                   audience: { type: object }
                   message: { type: string }
         '400':
-          description: Invalid body (no fields provided or malformed spec)
+          description: 'Invalid body (no fields provided, malformed spec, or spec on a platform audience)'
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
         '404': { $ref: '#/components/responses/NotFound' }
         '422':
-          description: The audience is not saved_targeting (uploaded/derived audiences are managed on the platform)
+          description: The audience has no platform counterpart to update
+        '501':
+          description: Platform audience updates are only supported on Meta
     delete:
       operationId: deleteAdAudience
       tags: [Ad Audiences]

data/spec/api/ad_audiences_api_spec.rb

@@ -97,8 +97,8 @@ describe 'AdAudiencesApi' do
   end
 
   # unit tests for update_ad_audience
-  # Update saved targeting audience
-  # Update a `saved_targeting` audience's name, description, or spec. Only `saved_targeting` audiences are updatable (they exist only on Zernio); uploaded/derived audiences return 422, delete and recreate those instead. `spec` replaces the stored spec wholesale (no merge). Ads already created from this audience are unaffected, they snapshot the targeting at creation. 
+  # Update an audience
+  # Update an audience. `saved_targeting` audiences accept `name`, `description`, and `spec` (full replacement, no merge, Zernio-only, no platform call). Platform audiences (uploaded/website/lookalike) accept `name` and `description` only, updated on the platform first and then mirrored locally; their rules are immutable, so `spec` returns 400 for them. Platform audience updates are Meta-only for now (other platforms return 501). Ads already created from a saved_targeting audience are unaffected, they snapshot the targeting at creation. 
   # @param audience_id 
   # @param update_ad_audience_request 
   # @param [Hash] opts the optional parameters

data/spec/api/ad_campaigns_api_spec.rb

@@ -44,6 +44,18 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for create_ad_campaign
+  # Create a standalone campaign (Meta)
+  # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass. Meta only.
+  # @param create_ad_campaign_request 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAdCampaign201Response]
+  describe 'create_ad_campaign 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_ad_campaign
   # Delete a campaign
   # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  Meta-only for now. Other platforms return 501 Not Implemented — fall back to DELETE /v1/ads/{adId} per ad in the meantime. 
@@ -70,6 +82,19 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for duplicate_ad_set
+  # Duplicate an ad set (Meta)
+  # Duplicates an ad set, including its ads and creatives by default (`deepCopy: true`), via Meta's native `POST /{adset-id}/copies`. The copy is created paused so callers can review before launching. `campaignId` retargets the copy into another campaign; omitted = the source's own campaign. The new hierarchy materializes asynchronously — sync discovery is triggered automatically (`syncAfter: false` to skip). Meta only.
+  # @param ad_set_id Source platform ad set ID
+  # @param duplicate_ad_set_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DuplicateAdSet200Response]
+  describe 'duplicate_ad_set 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_ad_set_details
   # Live ad-set details incl. learning phase (Meta)
   # Reads the ad set live from Meta, returned verbatim. The default projection includes `learning_stage_info` (learning-phase status: LEARNING / SUCCESS / FAIL / WAIVING — Meta omits its `status` key on paused ad sets), delivery settings, budgets, schedule and targeting. `fields` is a raw-passthrough override; unknown fields return Meta's 400 verbatim. Meta only.