chore: regenerate from OpenAPI spec

- Auto-generated SDK updates
- Version: 1.4.828

Author: github-actions[bot]

README.md

@@ -531,6 +531,7 @@ Both `from zernio import ...` and `from late import ...` work identically. The `
 | `ad_creatives.list_ad_creatives()` | Creative library |
 | `ad_creatives.list_ad_images()` | Ad image library |
 | `ad_creatives.list_ad_videos()` | Ad video library |
+| `ad_creatives.list_ads_tik_tok_identities()` | List TikTok ad identities |
 | `ad_creatives.list_partnership_ad_content()` | List partnership ad content |
 | `ad_creatives.list_partnership_ad_permissions()` | List partnership permissions |
 | `ad_creatives.create_ad_creative()` | Create a standalone creative |

openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Zernio API
-  version: "1.20.3"
+  version: "1.21.0"
   description: |
     API reference for Zernio. Authenticate with a Bearer API key.
     Base URL: https://zernio.com/api
@@ -49205,6 +49205,43 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
+  /v1/ads/tiktok-identities:
+    get:
+      x-resource-group: "ads"
+      operationId: listAdsTikTokIdentities
+      tags: ["Ad Creatives"]
+      x-platforms: ["tiktok"]
+      summary: List TikTok ad identities
+      description: "The identities an ad on this TikTok advertiser may run as (the profile shown on the ad): the advertiser's own TikTok accounts (TT_USER), Business Center authorized accounts (BC_AUTH_TT) and custom brand identities (CUSTOMIZED_USER). Pass the chosen `identityId` on POST /v1/ads/create or POST /v1/ads/boost. Spark-post identities (AUTH_CODE) are not listed; a Spark code creates its own."
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "A tiktok or tiktokads account ID" }
+        - { name: adAccountId, in: query, required: true, schema: { type: string }, description: "TikTok advertiser ID" }
+      responses:
+        '200':
+          description: Identities
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adAccountId: { type: string }
+                  identities:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        identityId: { type: string }
+                        identityType: { type: string, enum: [TT_USER, BC_AUTH_TT, CUSTOMIZED_USER] }
+                        displayName: { type: [string, "null"] }
+                        username: { type: [string, "null"] }
+                        profileImage: { type: [string, "null"] }
+                        identityAuthorizedBcId: { type: [string, "null"], description: "Business Center that authorized a BC_AUTH_TT identity" }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { $ref: '#/components/responses/AccountUnavailable' }
+        '409': { $ref: '#/components/responses/AccountConnectionRequired' }
   /v1/ads/instagram-accounts:
     get:
       operationId: listAdsInstagramAccounts
@@ -52178,6 +52215,8 @@ paths:
                 goal: { type: string, enum: [engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion], description: "Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views." }
                 adSetId: { type: string, description: "Meta, or TikTok with `smartPlus: true`. Attach the boosted post to this existing ad set instead of creating a campaign. On TikTok the id is an existing Smart+ ad group: the post is added as one more Spark ad in it (up to 30 per ad group), under the identity its `sparkAuthCode` creates; goal and budget are inherited from the Smart+ campaign; a regular ad group is rejected with a 400. Meta: The ad set then owns budget, schedule and targeting; sending those too is a 400." }
                 existingCampaignId: { type: string, description: "TikTok only. Create the ad group and the Spark ad under this existing TikTok campaign instead of creating a new campaign. The campaign keeps its own status and objective (the objective must fit `goal`). Cannot be combined with adSetId or smartPlus. On Meta use POST /v1/ads/create with existingCampaignId." }
+                identityId: { type: string, description: "TikTok only. The identity the ad runs as (the profile shown on the ad), from GET /v1/ads/tiktok-identities. Default: the connected TikTok account's own identity. Must be authorized on the advertiser or the call fails naming the available ones." }
+                identityType: { type: string, enum: [TT_USER, CUSTOMIZED_USER, BC_AUTH_TT], description: "TikTok only. Type of identityId; resolved from the advertiser's identity list when omitted." }
                 budget:
                   type: object
                   description: "Required unless adSetId is set."
@@ -53590,9 +53629,12 @@ paths:
                       type: string
                       format: uri
                       description: Public URL of a square brand image (≥98×98 px, JPG/PNG). Used as the brand avatar on the ad.
+                identityId:
+                  type: string
+                  description: "TikTok: the identity the ad runs as, from GET /v1/ads/tiktok-identities. Overrides the connected account's own identity; must be authorized on the advertiser."
                 identityType:
                   type: string
-                  enum: [TT_USER, CUSTOMIZED_USER]
+                  enum: [TT_USER, CUSTOMIZED_USER, BC_AUTH_TT]
                   description: |
                     TikTok only. Forces the identity attribution on the ad:
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "zernio-sdk"
-version = "1.4.827"
+version = "1.4.828"
 description = "The official Python library for the Zernio API"
 readme = "README.md"
 requires-python = ">=3.10"

src/late/__init__.py

@@ -42,7 +42,7 @@
     Visibility,
 )
 
-__version__ = "1.4.827"
+__version__ = "1.4.828"
 
 __all__ = [
     # Client

src/late/mcp/generated_tools.py

@@ -4776,6 +4776,8 @@ def ad_campaigns_boost_post(
         ad_set_name: str | None = None,
         ad_set_id: str | None = None,
         existing_campaign_id: str | None = None,
+        identity_id: str | None = None,
+        identity_type: str | None = None,
         budget: dict[str, Any] | None = None,
         instagram_account_id: str | None = None,
         destination_type: str | None = None,
@@ -4820,6 +4822,8 @@ def ad_campaigns_boost_post(
                 goal: Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views. (required)
                 ad_set_id: Meta, or TikTok with `smartPlus: true`. Attach the boosted post to this existing ad set instead of creating a campaign. On TikTok the id is an existing Smart+ ad group: the post is added as one more Spark ad in it (up to 30 per ad group), under the identity its `sparkAuthCode` creates; goal and budget are inherited from the Smart+ campaign; a regular ad group is rejected with a 400. Meta: The ad set then owns budget, schedule and targeting; sending those too is a 400.
                 existing_campaign_id: TikTok only. Create the ad group and the Spark ad under this existing TikTok campaign instead of creating a new campaign. The campaign keeps its own status and objective (the objective must fit `goal`). Cannot be combined with adSetId or smartPlus. On Meta use POST /v1/ads/create with existingCampaignId.
+                identity_id: TikTok only. The identity the ad runs as (the profile shown on the ad), from GET /v1/ads/tiktok-identities. Default: the connected TikTok account's own identity. Must be authorized on the advertiser or the call fails naming the available ones.
+                identity_type: TikTok only. Type of identityId; resolved from the advertiser's identity list when omitted.
                 budget: Required unless adSetId is set.
                 instagram_account_id: Meta only. Instagram identity the ad runs AS (creative.instagram_user_id), overriding the account linked to the Page. Live-verified against a Page-post creative.
                 destination_type: Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Independent of plain link CTAs and their goal. A messaging callToAction selects its destination automatically; an explicit destinationType must then match. Lead ads use ON_AD.
@@ -4957,6 +4961,8 @@ def ad_campaigns_boost_post(
                 goal=goal,
                 ad_set_id=ad_set_id,
                 existing_campaign_id=existing_campaign_id,
+                identity_id=identity_id,
+                identity_type=identity_type,
                 budget=budget,
                 instagram_account_id=instagram_account_id,
                 destination_type=destination_type,
@@ -5121,6 +5127,7 @@ def ad_campaigns_create_standalone_ad(
         dsa_beneficiary: str | None = None,
         dsa_payor: str | None = None,
         brand_identity: dict[str, Any] | None = None,
+        identity_id: str | None = None,
         identity_type: str | None = None,
         smart_plus: bool | None = None,
         user_os: list[str] | None = None,
@@ -5557,6 +5564,7 @@ def ad_campaigns_create_standalone_ad(
 
         Alternative: configure once via `PATCH /v1/connect/tiktok-ads`,
         then create ads without this field.
+                identity_id: TikTok: the identity the ad runs as, from GET /v1/ads/tiktok-identities. Overrides the connected account's own identity; must be authorized on the advertiser.
                 identity_type: TikTok only. Forces the identity attribution on the ad:
 
           - `TT_USER`: the posting account's open_id (real @username
@@ -5692,6 +5700,7 @@ def ad_campaigns_create_standalone_ad(
                 dsa_beneficiary=dsa_beneficiary,
                 dsa_payor=dsa_payor,
                 brand_identity=brand_identity,
+                identity_id=identity_id,
                 identity_type=identity_type,
                 smart_plus=smart_plus,
                 user_os=user_os,
@@ -5783,6 +5792,31 @@ def ad_creatives_get_ad_media(ad_id: str) -> str:
         except Exception as e:
             return f"Error: {e}"
 
+    @mcp.tool(
+        annotations=ToolAnnotations(
+            title="List TikTok ad identities",
+            readOnlyHint=True,
+            destructiveHint=False,
+            openWorldHint=False,
+        )
+    )
+    def ad_creatives_list_ads_tik_tok_identities(
+        account_id: str, ad_account_id: str
+    ) -> str:
+        """List TikTok ad identities
+
+        Args:
+            account_id: A tiktok or tiktokads account ID (required)
+            ad_account_id: TikTok advertiser ID (required)"""
+        client = _get_client()
+        try:
+            response = client.ad_creatives.list_ads_tik_tok_identities(
+                account_id=account_id, ad_account_id=ad_account_id
+            )
+            return _format_response(response)
+        except Exception as e:
+            return f"Error: {e}"
+
     @mcp.tool(
         annotations=ToolAnnotations(
             title="Creative library",

src/late/models/_generated/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   timestamp: 2026-09-17T23:47:46+00:00
+#   timestamp: 2026-09-18T01:04:46+00:00
 
 from __future__ import annotations
 

src/late/resources/_generated/ad_campaigns.py

@@ -941,6 +941,8 @@ def boost_post(
         ad_set_name: str | None = None,
         ad_set_id: str | None = None,
         existing_campaign_id: str | None = None,
+        identity_id: str | None = None,
+        identity_type: str | None = None,
         budget: dict[str, Any] | None = None,
         instagram_account_id: str | None = None,
         destination_type: str | None = None,
@@ -984,6 +986,8 @@ def boost_post(
             goal=goal,
             ad_set_id=ad_set_id,
             existing_campaign_id=existing_campaign_id,
+            identity_id=identity_id,
+            identity_type=identity_type,
             budget=budget,
             instagram_account_id=instagram_account_id,
             destination_type=destination_type,
@@ -1126,6 +1130,7 @@ def create_standalone_ad(
         dsa_beneficiary: str | None = None,
         dsa_payor: str | None = None,
         brand_identity: dict[str, Any] | None = None,
+        identity_id: str | None = None,
         identity_type: str | None = None,
         smart_plus: bool | None = None,
         user_os: list[str] | None = None,
@@ -1235,6 +1240,7 @@ def create_standalone_ad(
             dsa_beneficiary=dsa_beneficiary,
             dsa_payor=dsa_payor,
             brand_identity=brand_identity,
+            identity_id=identity_id,
             identity_type=identity_type,
             smart_plus=smart_plus,
             user_os=user_os,
@@ -2132,6 +2138,8 @@ async def aboost_post(
         ad_set_name: str | None = None,
         ad_set_id: str | None = None,
         existing_campaign_id: str | None = None,
+        identity_id: str | None = None,
+        identity_type: str | None = None,
         budget: dict[str, Any] | None = None,
         instagram_account_id: str | None = None,
         destination_type: str | None = None,
@@ -2175,6 +2183,8 @@ async def aboost_post(
             goal=goal,
             ad_set_id=ad_set_id,
             existing_campaign_id=existing_campaign_id,
+            identity_id=identity_id,
+            identity_type=identity_type,
             budget=budget,
             instagram_account_id=instagram_account_id,
             destination_type=destination_type,
@@ -2317,6 +2327,7 @@ async def acreate_standalone_ad(
         dsa_beneficiary: str | None = None,
         dsa_payor: str | None = None,
         brand_identity: dict[str, Any] | None = None,
+        identity_id: str | None = None,
         identity_type: str | None = None,
         smart_plus: bool | None = None,
         user_os: list[str] | None = None,
@@ -2426,6 +2437,7 @@ async def acreate_standalone_ad(
             dsa_beneficiary=dsa_beneficiary,
             dsa_payor=dsa_payor,
             brand_identity=brand_identity,
+            identity_id=identity_id,
             identity_type=identity_type,
             smart_plus=smart_plus,
             user_os=user_os,

src/late/resources/_generated/ad_creatives.py

@@ -105,6 +105,16 @@ def get_ad_media(self, ad_id: str) -> dict[str, Any]:
         """Direct video and image URLs for an ad"""
         return self._client._get(f"/v1/ads/{ad_id}/media")
 
+    def list_ads_tik_tok_identities(
+        self, account_id: str, ad_account_id: str
+    ) -> dict[str, Any]:
+        """List TikTok ad identities"""
+        params = self._build_params(
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+        )
+        return self._client._get("/v1/ads/tiktok-identities", params=params)
+
     def list_ad_creatives(
         self,
         account_id: str,
@@ -344,6 +354,16 @@ async def aget_ad_media(self, ad_id: str) -> dict[str, Any]:
         """Direct video and image URLs for an ad (async)"""
         return await self._client._aget(f"/v1/ads/{ad_id}/media")
 
+    async def alist_ads_tik_tok_identities(
+        self, account_id: str, ad_account_id: str
+    ) -> dict[str, Any]:
+        """List TikTok ad identities (async)"""
+        params = self._build_params(
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+        )
+        return await self._client._aget("/v1/ads/tiktok-identities", params=params)
+
     async def alist_ad_creatives(
         self,
         account_id: str,