zernio-sdk 0.0.802 → 0.0.804

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f936e21dd5c6a77014212469f67c007e1e0ddd9491d81ff03a23cccd38909e7a
-  data.tar.gz: 05c24d73a74d224f023bba45481edcdd8aa2fb9994c21383f3ef4eca125a946e
+  metadata.gz: 5a95651099e2701934e04a1e7a1cf92e078966302868e91e65a3a8368aaa4856
+  data.tar.gz: e4bef56410dffb7fcfec0950e333a47c41d1dc4700cadd1f42c5cf6411c5322a
 SHA512:
-  metadata.gz: 32ff531364e519dac0cca0c29b43f855d2a2428be868bfb6104474a2336d8be2f4ba7e7c5f8dbb8f5c99b8c4880d95c349e67ab841117ce7bc71b0e088a542da
-  data.tar.gz: d166c39907c55d2b3cc6d2865285eb4517f7c57ad053e1c4738b8252384649b4a76013791a07f5656ac1081dc44a27452daba215dee461df85dd98c25081c4e6
+  metadata.gz: b51cdc20292a5514c5a79e90659bcbfaf4c03bc1d204161a4570749da90a9d643e21235bd180ff60242641b91e7ad01d9b5c9eb1f60b7e644d856d8a7c909d22
+  data.tar.gz: 50f1f5c439a747c0171e5055d911f4fa181956623f66a6d80699adcd90b5d639222799eb9c80786c8ae44ffcae82f7839917d7981bdc3e3094611ac279e801e6

data/docs/CreatePostRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **title** | **String** |  | [optional] |
+| **title** | **String** | Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted). | [optional] |
 | **content** | **String** | Post caption/text. Optional when media is attached, all platforms have customContent, every platform entry is an X Article (platformSpecificData.article), or every platform entry is a LinkedIn text-free reshare (platformSpecificData.reshareUrl with no text). Required for other text-only posts. | [optional] |
 | **media_items** | [**Array<MediaItem>**](MediaItem.md) |  | [optional] |
 | **platforms** | [**Array<CreatePostRequestPlatformsInner>**](CreatePostRequestPlatformsInner.md) | Target platforms and accounts for this post. Required for non-draft posts (returns 400 if empty). Drafts can omit platforms. | [optional] |
@@ -13,7 +13,7 @@
 | **is_draft** | **Boolean** | When true, saves the post as a draft. When none of scheduledFor, publishNow, or queuedFromProfile are provided, the post defaults to draft automatically. | [optional][default to false] |
 | **timezone** | **String** |  | [optional][default to 'UTC'] |
 | **tags** | **Array<String>** | Tags/keywords. YouTube constraints: each tag max 100 chars, combined max 500 chars, duplicates auto-removed. | [optional] |
-| **hashtags** | **Array<String>** |  | [optional] |
+| **hashtags** | **Array<String>** | Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead. | [optional] |
 | **mentions** | **Array<String>** | Stored for reference only. This field does NOT automatically create @mentions when publishing. For LinkedIn @mentions, use the /v1/accounts/{accountId}/linkedin-mentions endpoint to resolve profile URLs to URNs, then embed the returned mentionFormat directly in the post content field. | [optional] |
 | **crossposting_enabled** | **Boolean** |  | [optional][default to true] |
 | **metadata** | **Hash<String, Object>** |  | [optional] |

data/docs/Post.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **_id** | **String** |  | [optional] |
 | **user_id** | [**PostUserId**](PostUserId.md) |  | [optional] |
-| **title** | **String** | YouTube: title must be ≤ 100 characters.  | [optional] |
+| **title** | **String** | Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted). | [optional] |
 | **content** | **String** |  | [optional] |
 | **media_items** | [**Array<MediaItem>**](MediaItem.md) |  | [optional] |
 | **platforms** | [**Array<PlatformTarget>**](PlatformTarget.md) |  | [optional] |
@@ -14,7 +14,7 @@
 | **timezone** | **String** |  | [optional] |
 | **status** | **String** |  | [optional] |
 | **tags** | **Array<String>** | YouTube constraints: each tag max 100 chars, combined max 500 chars, duplicates removed. | [optional] |
-| **hashtags** | **Array<String>** |  | [optional] |
+| **hashtags** | **Array<String>** | Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead. | [optional] |
 | **mentions** | **Array<String>** | Stored for reference only. This field does NOT automatically create @mentions when publishing. For LinkedIn @mentions, use the /v1/accounts/{accountId}/linkedin-mentions endpoint to resolve profile URLs to URNs, then embed the returned mentionFormat directly in the post content field. | [optional] |
 | **visibility** | **String** |  | [optional] |
 | **metadata** | **Hash<String, Object>** |  | [optional] |

data/docs/UpdatePostRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **title** | **String** |  | [optional] |
+| **title** | **String** | Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted). | [optional] |
 | **content** | **String** |  | [optional] |
 | **media_items** | [**Array<MediaItem>**](MediaItem.md) |  | [optional] |
 | **platforms** | [**Array<UpdatePostRequestPlatformsInner>**](UpdatePostRequestPlatformsInner.md) | Target platforms and accounts for this post. Each item must include platform and accountId. | [optional] |
@@ -14,7 +14,7 @@
 | **timezone** | **String** |  | [optional] |
 | **visibility** | **String** |  | [optional] |
 | **tags** | **Array<String>** |  | [optional] |
-| **hashtags** | **Array<String>** |  | [optional] |
+| **hashtags** | **Array<String>** | Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead. | [optional] |
 | **mentions** | **Array<String>** |  | [optional] |
 | **crossposting_enabled** | **Boolean** |  | [optional] |
 | **metadata** | **Hash<String, Object>** |  | [optional] |

data/docs/WebhookEventsApi.md

@@ -1491,7 +1491,7 @@ nil (empty response body)
 
 External post deleted event
 
-Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. 
+Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
 
 ### Examples
 
@@ -1763,7 +1763,7 @@ nil (empty response body)
 
 Post platform deleted event
 
-Fired when Zernio's background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. `platform.deletedAt` carries the detection time. Detection is listing-based: a false positive self-heals in Zernio's data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. 
+Fired when Zernio's background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. `platform.deletedAt` carries the detection time. Detection is listing-based: a false positive self-heals in Zernio's data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
 
 ### Examples
 

data/lib/zernio-sdk/api/webhook_events_api.rb

@@ -1406,7 +1406,7 @@ module Zernio
     end
 
     # External post deleted event
-    # Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. 
+    # Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
     # @param webhook_payload_external_post [WebhookPayloadExternalPost] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -1416,7 +1416,7 @@ module Zernio
     end
 
     # External post deleted event
-    # Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. 
+    # Fired when a tracked native post is detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
     # @param webhook_payload_external_post [WebhookPayloadExternalPost] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -1670,7 +1670,7 @@ module Zernio
     end
 
     # Post platform deleted event
-    # Fired when Zernio's background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. `platform.deletedAt` carries the detection time. Detection is listing-based: a false positive self-heals in Zernio's data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. 
+    # Fired when Zernio's background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. `platform.deletedAt` carries the detection time. Detection is listing-based: a false positive self-heals in Zernio's data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
     # @param webhook_payload_post_platform [WebhookPayloadPostPlatform] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -1680,7 +1680,7 @@ module Zernio
     end
 
     # Post platform deleted event
-    # Fired when Zernio&#39;s background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. &#x60;platform.deletedAt&#x60; carries the detection time. Detection is listing-based: a false positive self-heals in Zernio&#39;s data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. 
+    # Fired when Zernio&#39;s background sync detects that a platform target published through Zernio was later deleted on the platform (e.g. the user deleted the Instagram post natively). Detection is poll-driven (~hourly), not real-time, and fires once per platform target. &#x60;platform.deletedAt&#x60; carries the detection time. Detection is listing-based: a false positive self-heals in Zernio&#39;s data when the post reappears, but the event is not retracted. Coverage is bounded to the posts the platform listing returns. Detection is a diff against the posts a prior sync already indexed, so an account for which no post has ever been indexed can never emit this event, no matter how the subscription is configured. 
     # @param webhook_payload_post_platform [WebhookPayloadPostPlatform] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers

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

@@ -15,6 +15,7 @@ require 'time'
 
 module Zernio
   class CreatePostRequest < ApiModelBase
+    # Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted).
     attr_accessor :title
 
     # Post caption/text. Optional when media is attached, all platforms have customContent, every platform entry is an X Article (platformSpecificData.article), or every platform entry is a LinkedIn text-free reshare (platformSpecificData.reshareUrl with no text). Required for other text-only posts.
@@ -37,6 +38,7 @@ module Zernio
     # Tags/keywords. YouTube constraints: each tag max 100 chars, combined max 500 chars, duplicates auto-removed.
     attr_accessor :tags
 
+    # Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead.
     attr_accessor :hashtags
 
     # Stored for reference only. This field does NOT automatically create @mentions when publishing. For LinkedIn @mentions, use the /v1/accounts/{accountId}/linkedin-mentions endpoint to resolve profile URLs to URNs, then embed the returned mentionFormat directly in the post content field.

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

@@ -19,7 +19,7 @@ module Zernio
 
     attr_accessor :user_id
 
-    # YouTube: title must be ≤ 100 characters. 
+    # Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted).
     attr_accessor :title
 
     attr_accessor :content
@@ -37,6 +37,7 @@ module Zernio
     # YouTube constraints: each tag max 100 chars, combined max 500 chars, duplicates removed.
     attr_accessor :tags
 
+    # Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead.
     attr_accessor :hashtags
 
     # Stored for reference only. This field does NOT automatically create @mentions when publishing. For LinkedIn @mentions, use the /v1/accounts/{accountId}/linkedin-mentions endpoint to resolve profile URLs to URNs, then embed the returned mentionFormat directly in the post content field.

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

@@ -15,6 +15,7 @@ require 'time'
 
 module Zernio
   class UpdatePostRequest < ApiModelBase
+    # Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted).
     attr_accessor :title
 
     attr_accessor :content
@@ -37,6 +38,7 @@ module Zernio
 
     attr_accessor :tags
 
+    # Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead.
     attr_accessor :hashtags
 
     attr_accessor :mentions

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -155,7 +155,7 @@ x-documentation:
     - `post.tiktok.url_resolved` - A published TikTok post's public URL became available. TikTok exposes the numeric video id asynchronously, so `post.published` / `post.platform.published` can carry an empty `publishedUrl` for TikTok; this event delivers the URL once resolved (at most once per platform target). Never fires for drafts or private posts, which have no public URL.
     - `post.external.created` - A native post authored outside Zernio (e.g. a Google Business Profile localPost created in the Google UI) was detected by our sync for the first time. Poll-driven (~hourly), not real-time. Payload carries `post.source: "external"`.
     - `post.external.updated` - A tracked native post's text or media changed on the platform. Edits are detected by comparing text/media structure and (where the platform exposes it) the platform's own edit timestamp; media-URL-only refreshes do not fire this.
-    - `post.external.deleted` - A tracked native post was detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns.
+    - `post.external.deleted` - A tracked native post was detected as removed from the platform. `post.deletedAt` carries the detection time. Coverage is bounded to the most recent posts the platform listing returns, and detection is a diff against posts a prior sync already indexed, so an account for which no post has ever been indexed never emits it.
     - `account.connected` - Social account connected
     - `account.disconnected` - Social account disconnected (token expired)
     - `account.ads.initial_sync_completed` - Initial ads sync (discovery + 90-day backfill) completed for an ads-enabled account
@@ -5030,8 +5030,7 @@ components:
             - $ref: '#/components/schemas/User'
         title:
           type: string
-          description: |
-            YouTube: title must be ≤ 100 characters.
+          description: "Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted)."
         content: { type: string }
         mediaItems:
           type: array
@@ -5048,6 +5047,7 @@ components:
           items: { type: string }
         hashtags:
           type: array
+          description: "Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead."
           items: { type: string }
         mentions:
           type: array
@@ -9244,7 +9244,10 @@ webhooks:
         target. `platform.deletedAt` carries the detection time. Detection
         is listing-based: a false positive self-heals in Zernio's data when
         the post reappears, but the event is not retracted. Coverage is
-        bounded to the posts the platform listing returns.
+        bounded to the posts the platform listing returns. Detection is a diff
+        against the posts a prior sync already indexed, so an account for which no
+        post has ever been indexed can never emit this event, no matter how the
+        subscription is configured.
       tags: [Webhook Events]
       requestBody:
         required: true
@@ -9692,7 +9695,10 @@ webhooks:
       description: |
         Fired when a tracked native post is detected as removed from the platform.
         `post.deletedAt` carries the detection time. Coverage is bounded to the
-        most recent posts the platform listing returns.
+        most recent posts the platform listing returns. Detection is a diff against
+        the posts a prior sync already indexed, so an account for which no post has
+        ever been indexed can never emit this event, no matter how the subscription
+        is configured.
       tags: [Webhook Events]
       requestBody:
         required: true
@@ -14459,7 +14465,9 @@ paths:
             schema:
               type: object
               properties:
-                title: { type: string }
+                title:
+                  type: string
+                  description: "Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted)."
                 content:
                   type: string
                   description: 'Post caption/text. Optional when media is attached, all platforms have customContent, every platform entry is an X Article (platformSpecificData.article), or every platform entry is a LinkedIn text-free reshare (platformSpecificData.reshareUrl with no text). Required for other text-only posts.'
@@ -14515,6 +14523,7 @@ paths:
                   items: { type: string }
                 hashtags:
                   type: array
+                  description: "Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead."
                   items: { type: string }
                 mentions:
                   type: array
@@ -15157,7 +15166,9 @@ paths:
             schema:
               type: object
               properties:
-                title: { type: string }
+                title:
+                  type: string
+                  description: "Stored on the post for reference/display only. This field is NOT used as the video title when publishing. To set a YouTube video title, use platformSpecificData.title on the youtube platform target (falls back to the first line of content when omitted)."
                 content: { type: string }
                 mediaItems:
                   type: array
@@ -15197,6 +15208,7 @@ paths:
                   items: { type: string }
                 hashtags:
                   type: array
+                  description: "Stored for reference only. Hashtags are NOT automatically appended to the caption when publishing. Include hashtags directly in the content field (platforms like Instagram only support hashtags as caption text). For YouTube keywords, use the tags field instead."
                   items: { type: string }
                 mentions:
                   type: array

metadata

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