You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: "When omitted, the post keeps its current draft status. Send\
35326
+
\ `false` to promote a draft to scheduled (combined with `scheduledFor`,\
35327
+
\ `publishNow`, or a queue)."
35317
35328
type: boolean
35318
35329
timezone:
35319
35330
type: string
@@ -42237,6 +42248,7 @@ components:
42237
42248
- post.recycled
42238
42249
- post.platform.published
42239
42250
- post.platform.failed
42251
+
- post.tiktok.url_resolved
42240
42252
- post.external.created
42241
42253
- post.external.updated
42242
42254
- post.external.deleted
@@ -42323,6 +42335,7 @@ components:
42323
42335
- post.recycled
42324
42336
- post.platform.published
42325
42337
- post.platform.failed
42338
+
- post.tiktok.url_resolved
42326
42339
- post.external.created
42327
42340
- post.external.updated
42328
42341
- post.external.deleted
@@ -62201,6 +62214,7 @@ x-documentation:
62201
62214
- `post.recycled` - Post recycled (cloned and re-scheduled)
62202
62215
- `post.platform.published` - A single platform target inside a post finished publishing successfully. Fires once per platform-account as it terminates, without waiting for other platforms on the same post. Use this for incremental UIs; use `post.published` for the post-level rollup.
62203
62216
- `post.platform.failed` - A single platform target inside a post failed permanently. Temporary/retryable failures do NOT fire this event, only permanent ones, so retry loops stay quiet.
62217
+
- `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.
62204
62218
- `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"`.
62205
62219
- `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.
62206
62220
- `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.
Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited. Published posts can only have their recycling config updated.
1320
+
Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited. Published posts can only have their recycling config updated. To promote a draft to scheduled, send `isDraft: false` together with `scheduledFor` (or `publishNow: true`, or `queuedFromProfile`). If `isDraft` is omitted the post keeps its current draft status, so sending only `scheduledFor` to a draft returns 200 but the post remains a draft.
1321
1321
1322
1322
### Example
1323
1323
@@ -1394,7 +1394,7 @@ public class Example {
1394
1394
1395
1395
Update post
1396
1396
1397
-
Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited. Published posts can only have their recycling config updated.
1397
+
Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited. Published posts can only have their recycling config updated. To promote a draft to scheduled, send `isDraft: false` together with `scheduledFor` (or `publishNow: true`, or `queuedFromProfile`). If `isDraft` is omitted the post keeps its current draft status, so sending only `scheduledFor` to a draft returns 200 but the post remains a draft.
Copy file name to clipboardExpand all lines: docs/UpdatePostRequest.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@
13
13
|**platforms**|[**List<UpdatePostRequestPlatformsInner>**](UpdatePostRequestPlatformsInner.md)| Target platforms and accounts for this post. Each item must include platform and accountId. |[optional]|
14
14
|**scheduledFor**|**OffsetDateTime**||[optional]|
15
15
|**publishNow**|**Boolean**||[optional]|
16
-
|**isDraft**|**Boolean**||[optional]|
16
+
|**isDraft**|**Boolean**|When omitted, the post keeps its current draft status. Send `false` to promote a draft to scheduled (combined with `scheduledFor`, `publishNow`, or a queue).|[optional]|
Fired when an already-published TikTok platform entry gets its public URL backfilled. TikTok exposes the numeric video id asynchronously (often minutes after PUBLISH_COMPLETE), so the terminal events can carry an empty `publishedUrl` for TikTok. This event delivers `platform.publishedUrl` and the resolved `platform.platformPostId` once available. At most once per platform target; never fires for drafts or private posts (no public URL exists). Payload shape is identical to `post.platform.published`.
Fired when an already-published TikTok platform entry gets its public URL backfilled. TikTok exposes the numeric video id asynchronously (often minutes after PUBLISH_COMPLETE), so the terminal events can carry an empty `publishedUrl` for TikTok. This event delivers `platform.publishedUrl` and the resolved `platform.platformPostId` once available. At most once per platform target; never fires for drafts or private posts (no public URL exists). Payload shape is identical to `post.platform.published`.
Copy file name to clipboardExpand all lines: docs/WebhookPayloadPostPlatform.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
# WebhookPayloadPostPlatform
4
4
5
-
Webhook payload for the per-platform terminal events `post.platform.published` and `post.platform.failed`. Fires once per platform target inside a post as that platform reaches a terminal state (published or permanent failure). The `post` envelope mirrors the shape of `WebhookPayloadPost` so consumers can reuse rendering logic; the `platform` block identifies which specific platform transitioned; the `account` block identifies the connected social account behind that platform-write.
5
+
Webhook payload for the per-platform terminal events `post.platform.published` and `post.platform.failed`, and for `post.tiktok.url_resolved` (same shape, fired when a published TikTok post's public URL is backfilled). Terminal events fire once per platform target inside a post as that platform reaches a terminal state (published or permanent failure). The `post` envelope mirrors the shape of `WebhookPayloadPost` so consumers can reuse rendering logic; the `platform` block identifies which specific platform transitioned; the `account` block identifies the connected social account behind that platform-write.
6
6
7
7
## Properties
8
8
@@ -23,6 +23,7 @@ Webhook payload for the per-platform terminal events `post.platform.published` a
0 commit comments