@zernio/node 0.2.308 → 0.2.310

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -4011,15 +4011,27 @@ type TikTokPlatformData = {
4011
4011
  */
4012
4012
  allowStitch?: boolean;
4013
4013
  /**
4014
- * Type of commercial content disclosure
4014
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
4015
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
4016
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
4017
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
4018
+ * SELF_ONLY.
4019
+ *
4015
4020
  */
4016
4021
  commercialContentType?: 'none' | 'brand_organic' | 'brand_content';
4017
4022
  /**
4018
- * Whether the post promotes a brand partner
4023
+ * Whether the post promotes a brand partner (branded content / paid partnership).
4024
+ * Only needed to disclose BOTH types at once (set it alongside
4025
+ * commercialContentType "brand_organic"), or to override the value implied by
4026
+ * commercialContentType.
4027
+ *
4019
4028
  */
4020
4029
  brandPartnerPromote?: boolean;
4021
4030
  /**
4022
- * Whether the post is a brand organic post
4031
+ * Whether the post promotes the creator's own brand (brand organic). Only needed
4032
+ * to disclose BOTH types at once (set it alongside commercialContentType
4033
+ * "brand_content"), or to override the value implied by commercialContentType.
4034
+ *
4023
4035
  */
4024
4036
  isBrandOrganicPost?: boolean;
4025
4037
  /**
@@ -4060,7 +4072,12 @@ type TikTokPlatformData = {
4060
4072
  description?: string;
4061
4073
  };
4062
4074
  /**
4063
- * Type of commercial content disclosure
4075
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
4076
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
4077
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
4078
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
4079
+ * SELF_ONLY.
4080
+ *
4064
4081
  */
4065
4082
  type commercialContentType = 'none' | 'brand_organic' | 'brand_content';
4066
4083
  /**
@@ -4403,7 +4420,7 @@ type Webhook = {
4403
4420
  /**
4404
4421
  * Events subscribed to
4405
4422
  */
4406
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
4423
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
4407
4424
  /**
4408
4425
  * Whether webhook delivery is enabled
4409
4426
  */
@@ -5672,7 +5689,9 @@ type WebhookPayloadPost = {
5672
5689
  type event18 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
5673
5690
  /**
5674
5691
  * Webhook payload for the per-platform terminal events
5675
- * `post.platform.published` and `post.platform.failed`. Fires once
5692
+ * `post.platform.published` and `post.platform.failed`, and for
5693
+ * `post.tiktok.url_resolved` (same shape, fired when a published
5694
+ * TikTok post's public URL is backfilled). Terminal events fire once
5676
5695
  * per platform target inside a post as that platform reaches a
5677
5696
  * terminal state (published or permanent failure). The `post`
5678
5697
  * envelope mirrors the shape of `WebhookPayloadPost` so consumers
@@ -5686,7 +5705,7 @@ type WebhookPayloadPostPlatform = {
5686
5705
  * Stable webhook event ID.
5687
5706
  */
5688
5707
  id: string;
5689
- event: 'post.platform.published' | 'post.platform.failed';
5708
+ event: 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5690
5709
  post: {
5691
5710
  id: string;
5692
5711
  content: string;
@@ -5747,7 +5766,7 @@ type WebhookPayloadPostPlatform = {
5747
5766
  };
5748
5767
  timestamp: string;
5749
5768
  };
5750
- type event19 = 'post.platform.published' | 'post.platform.failed';
5769
+ type event19 = 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5751
5770
  /**
5752
5771
  * Webhook payload for reaction received events (WhatsApp, Telegram)
5753
5772
  */
@@ -8163,6 +8182,9 @@ type UpdatePostData = {
8163
8182
  }>;
8164
8183
  scheduledFor?: string;
8165
8184
  publishNow?: boolean;
8185
+ /**
8186
+ * When omitted, the post keeps its current draft status. Send `false` to promote a draft to scheduled (combined with `scheduledFor`, `publishNow`, or a queue).
8187
+ */
8166
8188
  isDraft?: boolean;
8167
8189
  timezone?: string;
8168
8190
  visibility?: 'public' | 'private' | 'unlisted';
@@ -12384,7 +12406,7 @@ type CreateWebhookSettingsData = {
12384
12406
  /**
12385
12407
  * Events to subscribe to (at least one required)
12386
12408
  */
12387
- events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12409
+ events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12388
12410
  /**
12389
12411
  * Enable or disable webhook delivery. Defaults to `true` when omitted.
12390
12412
  */
@@ -12425,7 +12447,7 @@ type UpdateWebhookSettingsData = {
12425
12447
  /**
12426
12448
  * Events to subscribe to. Must contain at least one event if provided.
12427
12449
  */
12428
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12450
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12429
12451
  /**
12430
12452
  * Enable or disable webhook delivery
12431
12453
  */
package/dist/index.d.ts CHANGED
@@ -4011,15 +4011,27 @@ type TikTokPlatformData = {
4011
4011
  */
4012
4012
  allowStitch?: boolean;
4013
4013
  /**
4014
- * Type of commercial content disclosure
4014
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
4015
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
4016
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
4017
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
4018
+ * SELF_ONLY.
4019
+ *
4015
4020
  */
4016
4021
  commercialContentType?: 'none' | 'brand_organic' | 'brand_content';
4017
4022
  /**
4018
- * Whether the post promotes a brand partner
4023
+ * Whether the post promotes a brand partner (branded content / paid partnership).
4024
+ * Only needed to disclose BOTH types at once (set it alongside
4025
+ * commercialContentType "brand_organic"), or to override the value implied by
4026
+ * commercialContentType.
4027
+ *
4019
4028
  */
4020
4029
  brandPartnerPromote?: boolean;
4021
4030
  /**
4022
- * Whether the post is a brand organic post
4031
+ * Whether the post promotes the creator's own brand (brand organic). Only needed
4032
+ * to disclose BOTH types at once (set it alongside commercialContentType
4033
+ * "brand_content"), or to override the value implied by commercialContentType.
4034
+ *
4023
4035
  */
4024
4036
  isBrandOrganicPost?: boolean;
4025
4037
  /**
@@ -4060,7 +4072,12 @@ type TikTokPlatformData = {
4060
4072
  description?: string;
4061
4073
  };
4062
4074
  /**
4063
- * Type of commercial content disclosure
4075
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
4076
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
4077
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
4078
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
4079
+ * SELF_ONLY.
4080
+ *
4064
4081
  */
4065
4082
  type commercialContentType = 'none' | 'brand_organic' | 'brand_content';
4066
4083
  /**
@@ -4403,7 +4420,7 @@ type Webhook = {
4403
4420
  /**
4404
4421
  * Events subscribed to
4405
4422
  */
4406
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
4423
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
4407
4424
  /**
4408
4425
  * Whether webhook delivery is enabled
4409
4426
  */
@@ -5672,7 +5689,9 @@ type WebhookPayloadPost = {
5672
5689
  type event18 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
5673
5690
  /**
5674
5691
  * Webhook payload for the per-platform terminal events
5675
- * `post.platform.published` and `post.platform.failed`. Fires once
5692
+ * `post.platform.published` and `post.platform.failed`, and for
5693
+ * `post.tiktok.url_resolved` (same shape, fired when a published
5694
+ * TikTok post's public URL is backfilled). Terminal events fire once
5676
5695
  * per platform target inside a post as that platform reaches a
5677
5696
  * terminal state (published or permanent failure). The `post`
5678
5697
  * envelope mirrors the shape of `WebhookPayloadPost` so consumers
@@ -5686,7 +5705,7 @@ type WebhookPayloadPostPlatform = {
5686
5705
  * Stable webhook event ID.
5687
5706
  */
5688
5707
  id: string;
5689
- event: 'post.platform.published' | 'post.platform.failed';
5708
+ event: 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5690
5709
  post: {
5691
5710
  id: string;
5692
5711
  content: string;
@@ -5747,7 +5766,7 @@ type WebhookPayloadPostPlatform = {
5747
5766
  };
5748
5767
  timestamp: string;
5749
5768
  };
5750
- type event19 = 'post.platform.published' | 'post.platform.failed';
5769
+ type event19 = 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5751
5770
  /**
5752
5771
  * Webhook payload for reaction received events (WhatsApp, Telegram)
5753
5772
  */
@@ -8163,6 +8182,9 @@ type UpdatePostData = {
8163
8182
  }>;
8164
8183
  scheduledFor?: string;
8165
8184
  publishNow?: boolean;
8185
+ /**
8186
+ * When omitted, the post keeps its current draft status. Send `false` to promote a draft to scheduled (combined with `scheduledFor`, `publishNow`, or a queue).
8187
+ */
8166
8188
  isDraft?: boolean;
8167
8189
  timezone?: string;
8168
8190
  visibility?: 'public' | 'private' | 'unlisted';
@@ -12384,7 +12406,7 @@ type CreateWebhookSettingsData = {
12384
12406
  /**
12385
12407
  * Events to subscribe to (at least one required)
12386
12408
  */
12387
- events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12409
+ events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12388
12410
  /**
12389
12411
  * Enable or disable webhook delivery. Defaults to `true` when omitted.
12390
12412
  */
@@ -12425,7 +12447,7 @@ type UpdateWebhookSettingsData = {
12425
12447
  /**
12426
12448
  * Events to subscribe to. Must contain at least one event if provided.
12427
12449
  */
12428
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12450
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12429
12451
  /**
12430
12452
  * Enable or disable webhook delivery
12431
12453
  */
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@zernio/node",
39
- version: "0.2.308",
39
+ version: "0.2.310",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@zernio/node",
8
- version: "0.2.308",
8
+ version: "0.2.310",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zernio/node",
3
- "version": "0.2.308",
3
+ "version": "0.2.310",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -730,6 +730,10 @@ export const getPost = <ThrowOnError extends boolean = false>(options: OptionsLe
730
730
  * Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited.
731
731
  * Published posts can only have their recycling config updated.
732
732
  *
733
+ * To promote a draft to scheduled, send `isDraft: false` together with `scheduledFor` (or `publishNow: true`,
734
+ * or `queuedFromProfile`). If `isDraft` is omitted the post keeps its current draft status, so sending only
735
+ * `scheduledFor` to a draft returns 200 but the post remains a draft.
736
+ *
733
737
  */
734
738
  export const updatePost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdatePostData, ThrowOnError>) => {
735
739
  return (options?.client ?? client).put<UpdatePostResponse, UpdatePostError, ThrowOnError>({
@@ -3377,15 +3377,27 @@ export type TikTokPlatformData = {
3377
3377
  */
3378
3378
  allowStitch?: boolean;
3379
3379
  /**
3380
- * Type of commercial content disclosure
3380
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
3381
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
3382
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
3383
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
3384
+ * SELF_ONLY.
3385
+ *
3381
3386
  */
3382
3387
  commercialContentType?: 'none' | 'brand_organic' | 'brand_content';
3383
3388
  /**
3384
- * Whether the post promotes a brand partner
3389
+ * Whether the post promotes a brand partner (branded content / paid partnership).
3390
+ * Only needed to disclose BOTH types at once (set it alongside
3391
+ * commercialContentType "brand_organic"), or to override the value implied by
3392
+ * commercialContentType.
3393
+ *
3385
3394
  */
3386
3395
  brandPartnerPromote?: boolean;
3387
3396
  /**
3388
- * Whether the post is a brand organic post
3397
+ * Whether the post promotes the creator's own brand (brand organic). Only needed
3398
+ * to disclose BOTH types at once (set it alongside commercialContentType
3399
+ * "brand_content"), or to override the value implied by commercialContentType.
3400
+ *
3389
3401
  */
3390
3402
  isBrandOrganicPost?: boolean;
3391
3403
  /**
@@ -3427,7 +3439,12 @@ export type TikTokPlatformData = {
3427
3439
  };
3428
3440
 
3429
3441
  /**
3430
- * Type of commercial content disclosure
3442
+ * Type of commercial content disclosure. Sufficient on its own: "brand_organic"
3443
+ * ("Your Brand") implies isBrandOrganicPost and "brand_content" ("Branded Content",
3444
+ * paid partnership) implies brandPartnerPromote, so you don't need to send the
3445
+ * boolean flags separately. Branded content cannot be posted with privacyLevel
3446
+ * SELF_ONLY.
3447
+ *
3431
3448
  */
3432
3449
  export type commercialContentType = 'none' | 'brand_organic' | 'brand_content';
3433
3450
 
@@ -3788,7 +3805,7 @@ export type Webhook = {
3788
3805
  /**
3789
3806
  * Events subscribed to
3790
3807
  */
3791
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
3808
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
3792
3809
  /**
3793
3810
  * Whether webhook delivery is enabled
3794
3811
  */
@@ -5107,7 +5124,9 @@ export type event18 = 'post.scheduled' | 'post.published' | 'post.failed' | 'pos
5107
5124
 
5108
5125
  /**
5109
5126
  * Webhook payload for the per-platform terminal events
5110
- * `post.platform.published` and `post.platform.failed`. Fires once
5127
+ * `post.platform.published` and `post.platform.failed`, and for
5128
+ * `post.tiktok.url_resolved` (same shape, fired when a published
5129
+ * TikTok post's public URL is backfilled). Terminal events fire once
5111
5130
  * per platform target inside a post as that platform reaches a
5112
5131
  * terminal state (published or permanent failure). The `post`
5113
5132
  * envelope mirrors the shape of `WebhookPayloadPost` so consumers
@@ -5121,7 +5140,7 @@ export type WebhookPayloadPostPlatform = {
5121
5140
  * Stable webhook event ID.
5122
5141
  */
5123
5142
  id: string;
5124
- event: 'post.platform.published' | 'post.platform.failed';
5143
+ event: 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5125
5144
  post: {
5126
5145
  id: string;
5127
5146
  content: string;
@@ -5183,7 +5202,7 @@ export type WebhookPayloadPostPlatform = {
5183
5202
  timestamp: string;
5184
5203
  };
5185
5204
 
5186
- export type event19 = 'post.platform.published' | 'post.platform.failed';
5205
+ export type event19 = 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved';
5187
5206
 
5188
5207
  /**
5189
5208
  * Webhook payload for reaction received events (WhatsApp, Telegram)
@@ -7761,6 +7780,9 @@ export type UpdatePostData = {
7761
7780
  }>;
7762
7781
  scheduledFor?: string;
7763
7782
  publishNow?: boolean;
7783
+ /**
7784
+ * When omitted, the post keeps its current draft status. Send `false` to promote a draft to scheduled (combined with `scheduledFor`, `publishNow`, or a queue).
7785
+ */
7764
7786
  isDraft?: boolean;
7765
7787
  timezone?: string;
7766
7788
  visibility?: 'public' | 'private' | 'unlisted';
@@ -12321,7 +12343,7 @@ export type CreateWebhookSettingsData = {
12321
12343
  /**
12322
12344
  * Events to subscribe to (at least one required)
12323
12345
  */
12324
- events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12346
+ events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12325
12347
  /**
12326
12348
  * Enable or disable webhook delivery. Defaults to `true` when omitted.
12327
12349
  */
@@ -12365,7 +12387,7 @@ export type UpdateWebhookSettingsData = {
12365
12387
  /**
12366
12388
  * Events to subscribe to. Must contain at least one event if provided.
12367
12389
  */
12368
- events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12390
+ events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
12369
12391
  /**
12370
12392
  * Enable or disable webhook delivery
12371
12393
  */