@postrun/js 2.9.0 → 2.11.0

package/dist/{types.gen-BUi197pC.d.ts → types.gen-CENLQ15A.d.ts}

@@ -5359,22 +5359,85 @@ type PostsListResponses = {
                 [key: string]: string | number | boolean;
             };
             variants: Array<{
+                platform: 'x';
+                post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+                /**
+                 * X (Twitter) organic post settings.
+                 */
+                settings: {
+                    /**
+                     * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
+                     */
+                    reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                    /**
+                     * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
+                     */
+                    quote_tweet_id?: string;
+                    /**
+                     * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                     */
+                    poll?: {
+                        /**
+                         * 2–4 options, each 1–25 characters.
+                         */
+                        options: Array<string>;
+                        /**
+                         * Poll duration in minutes (5 min – 7 days).
+                         */
+                        duration_minutes: number;
+                        /**
+                         * Reply restriction for the poll post (same enum).
+                         */
+                        reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                    };
+                    /**
+                     * Reply/thread chaining controls.
+                     */
+                    reply?: {
+                        /**
+                         * Parent post id; required when `reply` is present.
+                         */
+                        in_reply_to_tweet_id: string;
+                        /**
+                         * User ids dropped from the auto-mention chain.
+                         */
+                        exclude_reply_user_ids?: Array<string>;
+                        /**
+                         * Auto-prepend the parent participants' @mentions.
+                         */
+                        auto_populate_reply_metadata?: boolean;
+                    };
+                    /**
+                     * Post to an X Community.
+                     */
+                    community_id?: string;
+                    /**
+                     * Restrict to Super Followers (default false).
+                     */
+                    for_super_followers_only?: boolean;
+                    /**
+                     * Attach a place.
+                     */
+                    geo?: {
+                        place_id: string;
+                    };
+                    /**
+                     * Cards-API reference. Mutually exclusive with quote/poll/media.
+                     */
+                    card_uri?: string;
+                    /**
+                     * Tag ≤10 users on attached media.
+                     */
+                    media_tagged_user_ids?: Array<string>;
+                };
                 id: string;
                 object: 'post_variant';
                 /**
                  * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
                  */
                 connection_id: string | null;
-                platform: 'x' | 'linkedin' | 'facebook_page' | 'instagram' | 'tiktok';
-                post_type: 'text' | 'single_image' | 'multi_image' | 'video' | 'reel' | 'carousel';
                 body: string | null;
                 status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
-                /**
-                 * Native per-platform settings, as stored.
-                 */
-                settings: {
-                    [key: string]: unknown;
-                };
                 /**
                  * Per-variant schedule override (ISO-8601); null inherits the post.
                  */
@@ -5409,351 +5472,504 @@ type PostsListResponses = {
                      */
                     alt_text_override: string | null;
                 }>;
-            }>;
-            /**
-             * ISO-8601 creation time.
-             */
-            created_at: string;
-            /**
-             * ISO-8601 last-update time.
-             */
-            updated_at: string;
-        }>;
-        /**
-         * Total items matching the query, across all pages.
-         */
-        total: number;
-        /**
-         * The limit applied to this page.
-         */
-        limit: number;
-        /**
-         * The offset applied to this page.
-         */
-        offset: number;
-        /**
-         * True if more items exist after this page.
-         */
-        has_more: boolean;
-    };
-};
-type PostsListResponse = PostsListResponses[keyof PostsListResponses];
-type PostsCreateData = {
-    body: {
-        /**
-         * Profile that owns this post.
-         */
-        profile_id: string;
-        /**
-         * now = publish immediately; schedule = publish at schedule_at; draft = store only.
-         */
-        publish?: 'now' | 'schedule' | 'draft';
-        /**
-         * UTC ISO-8601 publish time. Required when publish = schedule.
-         */
-        schedule_at?: string;
-        external_id?: string;
-        /**
-         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
-         */
-        metadata?: {
-            [key: string]: string | number | boolean;
-        };
-        tags?: Array<string>;
-        notes?: string;
-        /**
-         * Validate the post without persisting or scheduling.
-         */
-        dry_run?: boolean;
-        /**
-         * A single platform variant of a post: connection, platform, explicit post_type, body, ordered media, and native typed settings.
-         */
-        variants: Array<{
-            platform: 'x';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
-            /**
-             * X (Twitter) organic post settings.
-             */
-            settings?: {
-                /**
-                 * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
-                 */
-                reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
-                /**
-                 * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
-                 */
-                quote_tweet_id?: string;
+            } | {
+                platform: 'linkedin';
+                post_type: 'text' | 'single_image' | 'multi_image' | 'video';
                 /**
-                 * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                 * LinkedIn personal member post settings.
                  */
-                poll?: {
+                settings: {
                     /**
-                     * 2–4 options, each 1–25 characters.
+                     * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
                      */
-                    options: Array<string>;
+                    visibility: 'PUBLIC' | 'CONNECTIONS';
                     /**
-                     * Poll duration in minutes (5 min – 7 days).
+                     * Which content shape this post carries (mutually exclusive with the others).
                      */
-                    duration_minutes: number;
+                    content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
                     /**
-                     * Reply restriction for the poll post (same enum).
+                     * An article share card.
                      */
-                    reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
-                };
-                /**
-                 * Reply/thread chaining controls.
-                 */
-                reply?: {
+                    article?: {
+                        /**
+                         * Article URL. Required for an article post.
+                         */
+                        source: string;
+                        /**
+                         * Article headline, ≤400 characters.
+                         */
+                        title?: string;
+                        /**
+                         * Subtext on the article card, ≤4086 characters.
+                         */
+                        description?: string;
+                        /**
+                         * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                         */
+                        thumbnail_media_id?: string;
+                    };
                     /**
-                     * Parent post id; required when `reply` is present.
+                     * A LinkedIn poll (mutually exclusive with other content).
                      */
-                    in_reply_to_tweet_id: string;
+                    poll?: {
+                        /**
+                         * The poll question, ≤140 characters.
+                         */
+                        question: string;
+                        /**
+                         * 2–4 options, each 1–30 characters.
+                         */
+                        options: Array<string>;
+                        /**
+                         * How long the poll runs.
+                         */
+                        duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
+                    };
                     /**
-                     * User ids dropped from the auto-mention chain.
+                     * Document-post display options (asset rides on media[]).
                      */
-                    exclude_reply_user_ids?: Array<string>;
+                    document?: {
+                        /**
+                         * Display title shown above the document. Required for document posts.
+                         */
+                        title: string;
+                    };
                     /**
-                     * Auto-prepend the parent participants' @mentions.
+                     * Disable resharing of this post (default false).
                      */
-                    auto_populate_reply_metadata?: boolean;
+                    disable_reshare?: boolean;
+                    /**
+                     * Inline @mentions encoded into the commentary at publish.
+                     */
+                    mentions?: Array<{
+                        /**
+                         * Whether the mentioned entity is a member or an organization.
+                         */
+                        type: 'person' | 'organization';
+                        /**
+                         * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                         */
+                        name: string;
+                        /**
+                         * The mentioned entity urn (supplied by the caller).
+                         */
+                        urn: string;
+                    }>;
                 };
+                id: string;
+                object: 'post_variant';
                 /**
-                 * Post to an X Community.
+                 * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
                  */
-                community_id?: string;
+                connection_id: string | null;
+                body: string | null;
+                status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
                 /**
-                 * Restrict to Super Followers (default false).
+                 * Per-variant schedule override (ISO-8601); null inherits the post.
                  */
-                for_super_followers_only?: boolean;
+                schedule_at: string | null;
+                result: {
+                    platform_post_id: string;
+                    permalink: string | null;
+                    published_at: string;
+                } | null;
+                error: {
+                    code: string;
+                    message: string;
+                    /**
+                     * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                     */
+                    display_error: string;
+                } | null;
+                media: Array<{
+                    media_id: string;
+                    /**
+                     * Ordering of this media within the variant (e.g. carousel order).
+                     */
+                    position: number;
+                    /**
+                     * Per-variant crop, applied at publish; null = none.
+                     */
+                    crop_box: {
+                        [key: string]: unknown;
+                    } | null;
+                    /**
+                     * Per-variant alt text; falls back to the asset’s alt_text.
+                     */
+                    alt_text_override: string | null;
+                }>;
+            } | {
+                platform: 'facebook_page';
+                post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
                 /**
-                 * Attach a place.
+                 * Facebook Page organic post settings.
                  */
-                geo?: {
-                    place_id: string;
+                settings: {
+                    /**
+                     * URL to unfurl. A feed post needs a body (message) OR a link.
+                     */
+                    link?: string;
                 };
+                id: string;
+                object: 'post_variant';
                 /**
-                 * Cards-API reference. Mutually exclusive with quote/poll/media.
+                 * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
                  */
-                card_uri?: string;
+                connection_id: string | null;
+                body: string | null;
+                status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
                 /**
-                 * Tag ≤10 users on attached media.
+                 * Per-variant schedule override (ISO-8601); null inherits the post.
                  */
-                media_tagged_user_ids?: Array<string>;
-            };
-        } | {
-            platform: 'linkedin';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
+                schedule_at: string | null;
+                result: {
+                    platform_post_id: string;
+                    permalink: string | null;
+                    published_at: string;
                 } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
-            /**
-             * LinkedIn personal member post settings.
-             */
-            settings: {
-                /**
-                 * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
-                 */
-                visibility: 'PUBLIC' | 'CONNECTIONS';
-                /**
-                 * Which content shape this post carries (mutually exclusive with the others).
-                 */
-                content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
-                /**
-                 * An article share card.
-                 */
-                article?: {
+                error: {
+                    code: string;
+                    message: string;
                     /**
-                     * Article URL. Required for an article post.
+                     * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
                      */
-                    source: string;
+                    display_error: string;
+                } | null;
+                media: Array<{
+                    media_id: string;
                     /**
-                     * Article headline, ≤400 characters.
+                     * Ordering of this media within the variant (e.g. carousel order).
                      */
-                    title?: string;
+                    position: number;
                     /**
-                     * Subtext on the article card, ≤4086 characters.
+                     * Per-variant crop, applied at publish; null = none.
                      */
-                    description?: string;
+                    crop_box: {
+                        [key: string]: unknown;
+                    } | null;
                     /**
-                     * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                     * Per-variant alt text; falls back to the asset’s alt_text.
                      */
-                    thumbnail_media_id?: string;
-                };
+                    alt_text_override: string | null;
+                }>;
+            } | {
+                platform: 'instagram';
+                post_type: 'single_image' | 'carousel' | 'reel';
                 /**
-                 * A LinkedIn poll (mutually exclusive with other content).
+                 * Instagram organic post settings (feed image/carousel + reels).
                  */
-                poll?: {
+                settings: {
                     /**
-                     * The poll question, ≤140 characters.
+                     * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
                      */
-                    question: string;
+                    media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
                     /**
-                     * 2–4 options, each 1–30 characters.
+                     * Facebook Page id representing a location.
                      */
-                    options: Array<string>;
+                    location_id?: string;
                     /**
-                     * How long the poll runs.
+                     * Tag users on an image; x/y are fractional positions in [0,1].
                      */
-                    duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
-                };
-                /**
-                 * Document-post display options (asset rides on media[]).
-                 */
-                document?: {
+                    user_tags?: Array<{
+                        /**
+                         * IG username to tag.
+                         */
+                        username: string;
+                        /**
+                         * Horizontal position on the image, in [0,1].
+                         */
+                        x: number;
+                        /**
+                         * Vertical position on the image, in [0,1].
+                         */
+                        y: number;
+                    }>;
                     /**
-                     * Display title shown above the document. Required for document posts.
+                     * ≤3 co-author usernames.
                      */
-                    title: string;
+                    collaborators?: Array<string>;
+                    /**
+                     * Reel also appears in the main feed.
+                     */
+                    share_to_feed?: boolean;
+                    /**
+                     * Reel cover frame offset (ms).
+                     */
+                    thumb_offset?: number;
+                    /**
+                     * Custom reel cover image URL.
+                     */
+                    cover_url?: string;
+                    /**
+                     * Label for the reel's original audio.
+                     */
+                    audio_name?: string;
                 };
+                id: string;
+                object: 'post_variant';
                 /**
-                 * Disable resharing of this post (default false).
+                 * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
                  */
-                disable_reshare?: boolean;
+                connection_id: string | null;
+                body: string | null;
+                status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
                 /**
-                 * Inline @mentions encoded into the commentary at publish.
+                 * Per-variant schedule override (ISO-8601); null inherits the post.
                  */
-                mentions?: Array<{
+                schedule_at: string | null;
+                result: {
+                    platform_post_id: string;
+                    permalink: string | null;
+                    published_at: string;
+                } | null;
+                error: {
+                    code: string;
+                    message: string;
                     /**
-                     * Whether the mentioned entity is a member or an organization.
+                     * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
                      */
-                    type: 'person' | 'organization';
+                    display_error: string;
+                } | null;
+                media: Array<{
+                    media_id: string;
                     /**
-                     * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                     * Ordering of this media within the variant (e.g. carousel order).
                      */
-                    name: string;
+                    position: number;
                     /**
-                     * The mentioned entity urn (supplied by the caller).
+                     * Per-variant crop, applied at publish; null = none.
                      */
-                    urn: string;
+                    crop_box: {
+                        [key: string]: unknown;
+                    } | null;
+                    /**
+                     * Per-variant alt text; falls back to the asset’s alt_text.
+                     */
+                    alt_text_override: string | null;
                 }>;
-            };
-        } | {
-            platform: 'instagram';
-            post_type: 'single_image' | 'carousel' | 'reel';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
-            /**
-             * Instagram organic post settings (feed image/carousel + reels).
-             */
-            settings: {
+            } | {
+                platform: 'tiktok';
+                post_type: 'video' | 'single_image' | 'carousel';
                 /**
-                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
+                 * TikTok organic post settings (Direct Post: video + photo).
                  */
-                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
+                settings: {
+                    /**
+                     * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                     */
+                    privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                    /**
+                     * Disable comments on this post.
+                     */
+                    disable_comment?: boolean;
+                    /**
+                     * Disable Duet (video only).
+                     */
+                    disable_duet?: boolean;
+                    /**
+                     * Disable Stitch (video only).
+                     */
+                    disable_stitch?: boolean;
+                    /**
+                     * Video cover frame offset (ms). Video posts only.
+                     */
+                    video_cover_timestamp_ms?: number;
+                    /**
+                     * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                     */
+                    photo_cover_index?: number;
+                    /**
+                     * Auto-add a TikTok soundtrack. Photo posts only.
+                     */
+                    auto_add_music?: boolean;
+                    /**
+                     * Disclose a paid partnership (branded content).
+                     */
+                    brand_content_toggle?: boolean;
+                    /**
+                     * Disclose own-brand promotional content.
+                     */
+                    brand_organic_toggle?: boolean;
+                    /**
+                     * Disclose AI-generated content. Video posts only.
+                     */
+                    is_aigc?: boolean;
+                };
+                id: string;
+                object: 'post_variant';
                 /**
-                 * Facebook Page id representing a location.
+                 * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
                  */
-                location_id?: string;
+                connection_id: string | null;
+                body: string | null;
+                status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
                 /**
-                 * Tag users on an image; x/y are fractional positions in [0,1].
+                 * Per-variant schedule override (ISO-8601); null inherits the post.
                  */
-                user_tags?: Array<{
+                schedule_at: string | null;
+                result: {
+                    platform_post_id: string;
+                    permalink: string | null;
+                    published_at: string;
+                } | null;
+                error: {
+                    code: string;
+                    message: string;
                     /**
-                     * IG username to tag.
+                     * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
                      */
-                    username: string;
+                    display_error: string;
+                } | null;
+                media: Array<{
+                    media_id: string;
                     /**
-                     * Horizontal position on the image, in [0,1].
+                     * Ordering of this media within the variant (e.g. carousel order).
                      */
-                    x: number;
+                    position: number;
                     /**
-                     * Vertical position on the image, in [0,1].
+                     * Per-variant crop, applied at publish; null = none.
                      */
-                    y: number;
+                    crop_box: {
+                        [key: string]: unknown;
+                    } | null;
+                    /**
+                     * Per-variant alt text; falls back to the asset’s alt_text.
+                     */
+                    alt_text_override: string | null;
                 }>;
-                /**
-                 * ≤3 co-author usernames.
-                 */
-                collaborators?: Array<string>;
-                /**
-                 * Reel also appears in the main feed.
-                 */
-                share_to_feed?: boolean;
-                /**
-                 * Reel cover frame offset (ms).
-                 */
-                thumb_offset?: number;
-                /**
-                 * Custom reel cover image URL.
-                 */
-                cover_url?: string;
-                /**
-                 * Label for the reel's original audio.
-                 */
-                audio_name?: string;
-            };
-        } | {
-            platform: 'facebook_page';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
+            }>;
             /**
-             * The connected account this variant publishes to.
+             * ISO-8601 creation time.
+             */
+            created_at: string;
+            /**
+             * ISO-8601 last-update time.
+             */
+            updated_at: string;
+        }>;
+        /**
+         * Total items matching the query, across all pages.
+         */
+        total: number;
+        /**
+         * The limit applied to this page.
+         */
+        limit: number;
+        /**
+         * The offset applied to this page.
+         */
+        offset: number;
+        /**
+         * True if more items exist after this page.
+         */
+        has_more: boolean;
+    };
+};
+type PostsListResponse = PostsListResponses[keyof PostsListResponses];
+type PostsCreateData = {
+    body: {
+        /**
+         * Profile that owns this post.
+         */
+        profile_id: string;
+        /**
+         * now = publish immediately; schedule = publish at schedule_at; draft = store only.
+         */
+        publish?: 'now' | 'schedule' | 'draft';
+        /**
+         * UTC ISO-8601 publish time. Required when publish = schedule.
+         */
+        schedule_at?: string;
+        external_id?: string;
+        /**
+         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
+         */
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+        tags?: Array<string>;
+        notes?: string;
+        /**
+         * Validate the post without persisting or scheduling.
+         */
+        dry_run?: boolean;
+        /**
+         * A single platform variant of a post: connection, platform, explicit post_type, body, ordered media, and native typed settings.
+         */
+        variants: Array<{
+            platform: 'x';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * X (Twitter) organic post settings.
+             */
+            settings?: {
+                /**
+                 * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
+                 */
+                reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                /**
+                 * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
+                 */
+                quote_tweet_id?: string;
+                /**
+                 * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                 */
+                poll?: {
+                    /**
+                     * 2–4 options, each 1–25 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * Poll duration in minutes (5 min – 7 days).
+                     */
+                    duration_minutes: number;
+                    /**
+                     * Reply restriction for the poll post (same enum).
+                     */
+                    reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                };
+                /**
+                 * Reply/thread chaining controls.
+                 */
+                reply?: {
+                    /**
+                     * Parent post id; required when `reply` is present.
+                     */
+                    in_reply_to_tweet_id: string;
+                    /**
+                     * User ids dropped from the auto-mention chain.
+                     */
+                    exclude_reply_user_ids?: Array<string>;
+                    /**
+                     * Auto-prepend the parent participants' @mentions.
+                     */
+                    auto_populate_reply_metadata?: boolean;
+                };
+                /**
+                 * Post to an X Community.
+                 */
+                community_id?: string;
+                /**
+                 * Restrict to Super Followers (default false).
+                 */
+                for_super_followers_only?: boolean;
+                /**
+                 * Attach a place.
+                 */
+                geo?: {
+                    place_id: string;
+                };
+                /**
+                 * Cards-API reference. Mutually exclusive with quote/poll/media.
+                 */
+                card_uri?: string;
+                /**
+                 * Tag ≤10 users on attached media.
+                 */
+                media_tagged_user_ids?: Array<string>;
+            };
+            /**
+             * The connected account this variant publishes to.
              */
             connection_id: string;
             /**
@@ -5776,18 +5992,90 @@ type PostsCreateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
             /**
-             * Facebook Page organic post settings.
+             * LinkedIn personal member post settings.
              */
-            settings?: {
+            settings: {
                 /**
-                 * URL to unfurl. A feed post needs a body (message) OR a link.
+                 * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
                  */
-                link?: string;
+                visibility: 'PUBLIC' | 'CONNECTIONS';
+                /**
+                 * Which content shape this post carries (mutually exclusive with the others).
+                 */
+                content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
+                /**
+                 * An article share card.
+                 */
+                article?: {
+                    /**
+                     * Article URL. Required for an article post.
+                     */
+                    source: string;
+                    /**
+                     * Article headline, ≤400 characters.
+                     */
+                    title?: string;
+                    /**
+                     * Subtext on the article card, ≤4086 characters.
+                     */
+                    description?: string;
+                    /**
+                     * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                     */
+                    thumbnail_media_id?: string;
+                };
+                /**
+                 * A LinkedIn poll (mutually exclusive with other content).
+                 */
+                poll?: {
+                    /**
+                     * The poll question, ≤140 characters.
+                     */
+                    question: string;
+                    /**
+                     * 2–4 options, each 1–30 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * How long the poll runs.
+                     */
+                    duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
+                };
+                /**
+                 * Document-post display options (asset rides on media[]).
+                 */
+                document?: {
+                    /**
+                     * Display title shown above the document. Required for document posts.
+                     */
+                    title: string;
+                };
+                /**
+                 * Disable resharing of this post (default false).
+                 */
+                disable_reshare?: boolean;
+                /**
+                 * Inline @mentions encoded into the commentary at publish.
+                 */
+                mentions?: Array<{
+                    /**
+                     * Whether the mentioned entity is a member or an organization.
+                     */
+                    type: 'person' | 'organization';
+                    /**
+                     * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                     */
+                    name: string;
+                    /**
+                     * The mentioned entity urn (supplied by the caller).
+                     */
+                    urn: string;
+                }>;
             };
-        } | {
-            platform: 'tiktok';
-            post_type: 'video' | 'single_image' | 'carousel';
             /**
              * The connected account this variant publishes to.
              */
@@ -5812,30 +6100,146 @@ type PostsCreateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
             /**
-             * TikTok organic post settings (Direct Post: video + photo).
+             * Instagram organic post settings (feed image/carousel + reels).
              */
-            settings?: {
+            settings: {
                 /**
-                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
                  */
-                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
                 /**
-                 * Disable comments on this post.
+                 * Facebook Page id representing a location.
                  */
-                disable_comment?: boolean;
+                location_id?: string;
                 /**
-                 * Disable Duet (video only).
+                 * Tag users on an image; x/y are fractional positions in [0,1].
                  */
-                disable_duet?: boolean;
+                user_tags?: Array<{
+                    /**
+                     * IG username to tag.
+                     */
+                    username: string;
+                    /**
+                     * Horizontal position on the image, in [0,1].
+                     */
+                    x: number;
+                    /**
+                     * Vertical position on the image, in [0,1].
+                     */
+                    y: number;
+                }>;
                 /**
-                 * Disable Stitch (video only).
+                 * ≤3 co-author usernames.
                  */
-                disable_stitch?: boolean;
+                collaborators?: Array<string>;
                 /**
-                 * Video cover frame offset (ms). Video posts only.
+                 * Reel also appears in the main feed.
                  */
-                video_cover_timestamp_ms?: number;
+                share_to_feed?: boolean;
+                /**
+                 * Reel cover frame offset (ms).
+                 */
+                thumb_offset?: number;
+                /**
+                 * Custom reel cover image URL.
+                 */
+                cover_url?: string;
+                /**
+                 * Label for the reel's original audio.
+                 */
+                audio_name?: string;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
+            /**
+             * Facebook Page organic post settings.
+             */
+            settings?: {
+                /**
+                 * URL to unfurl. A feed post needs a body (message) OR a link.
+                 */
+                link?: string;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
+            /**
+             * TikTok organic post settings (Direct Post: video + photo).
+             */
+            settings?: {
+                /**
+                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 */
+                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                /**
+                 * Disable comments on this post.
+                 */
+                disable_comment?: boolean;
+                /**
+                 * Disable Duet (video only).
+                 */
+                disable_duet?: boolean;
+                /**
+                 * Disable Stitch (video only).
+                 */
+                disable_stitch?: boolean;
+                /**
+                 * Video cover frame offset (ms). Video posts only.
+                 */
+                video_cover_timestamp_ms?: number;
                 /**
                  * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
                  */
@@ -5857,6 +6261,30 @@ type PostsCreateData = {
                  */
                 is_aigc?: boolean;
             };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
         }>;
     };
     path?: never;
@@ -6124,22 +6552,85 @@ type PostsCreateResponses = {
             [key: string]: string | number | boolean;
         };
         variants: Array<{
+            platform: 'x';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * X (Twitter) organic post settings.
+             */
+            settings: {
+                /**
+                 * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
+                 */
+                reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                /**
+                 * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
+                 */
+                quote_tweet_id?: string;
+                /**
+                 * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                 */
+                poll?: {
+                    /**
+                     * 2–4 options, each 1–25 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * Poll duration in minutes (5 min – 7 days).
+                     */
+                    duration_minutes: number;
+                    /**
+                     * Reply restriction for the poll post (same enum).
+                     */
+                    reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                };
+                /**
+                 * Reply/thread chaining controls.
+                 */
+                reply?: {
+                    /**
+                     * Parent post id; required when `reply` is present.
+                     */
+                    in_reply_to_tweet_id: string;
+                    /**
+                     * User ids dropped from the auto-mention chain.
+                     */
+                    exclude_reply_user_ids?: Array<string>;
+                    /**
+                     * Auto-prepend the parent participants' @mentions.
+                     */
+                    auto_populate_reply_metadata?: boolean;
+                };
+                /**
+                 * Post to an X Community.
+                 */
+                community_id?: string;
+                /**
+                 * Restrict to Super Followers (default false).
+                 */
+                for_super_followers_only?: boolean;
+                /**
+                 * Attach a place.
+                 */
+                geo?: {
+                    place_id: string;
+                };
+                /**
+                 * Cards-API reference. Mutually exclusive with quote/poll/media.
+                 */
+                card_uri?: string;
+                /**
+                 * Tag ≤10 users on attached media.
+                 */
+                media_tagged_user_ids?: Array<string>;
+            };
             id: string;
             object: 'post_variant';
             /**
              * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
             connection_id: string | null;
-            platform: 'x' | 'linkedin' | 'facebook_page' | 'instagram' | 'tiktok';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video' | 'reel' | 'carousel';
             body: string | null;
             status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
-            /**
-             * Native per-platform settings, as stored.
-             */
-            settings: {
-                [key: string]: unknown;
-            };
             /**
              * Per-variant schedule override (ISO-8601); null inherits the post.
              */
@@ -6174,63 +6665,656 @@ type PostsCreateResponses = {
                  */
                 alt_text_override: string | null;
             }>;
-        }>;
-        /**
-         * ISO-8601 creation time.
-         */
-        created_at: string;
-        /**
-         * ISO-8601 last-update time.
-         */
-        updated_at: string;
-        /**
-         * Whether this was a validate-only dry run.
-         */
-        dry_run: boolean;
-        /**
-         * Whether the post was actually persisted (false on a dry run).
-         */
-        executed: boolean;
-    };
-};
-type PostsCreateResponse = PostsCreateResponses[keyof PostsCreateResponses];
-type PostsDeleteData = {
-    body?: never;
-    path: {
-        /**
-         * The post id.
-         */
-        id: string;
-    };
-    query?: never;
-    url: '/posts/{id}';
-};
-type PostsDeleteErrors = {
-    /**
-     * An RFC 9457 problem response.
-     */
-    400: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'idempotency_key_invalid';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * LinkedIn personal member post settings.
+             */
+            settings: {
+                /**
+                 * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
+                 */
+                visibility: 'PUBLIC' | 'CONNECTIONS';
+                /**
+                 * Which content shape this post carries (mutually exclusive with the others).
+                 */
+                content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
+                /**
+                 * An article share card.
+                 */
+                article?: {
+                    /**
+                     * Article URL. Required for an article post.
+                     */
+                    source: string;
+                    /**
+                     * Article headline, ≤400 characters.
+                     */
+                    title?: string;
+                    /**
+                     * Subtext on the article card, ≤4086 characters.
+                     */
+                    description?: string;
+                    /**
+                     * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                     */
+                    thumbnail_media_id?: string;
+                };
+                /**
+                 * A LinkedIn poll (mutually exclusive with other content).
+                 */
+                poll?: {
+                    /**
+                     * The poll question, ≤140 characters.
+                     */
+                    question: string;
+                    /**
+                     * 2–4 options, each 1–30 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * How long the poll runs.
+                     */
+                    duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
+                };
+                /**
+                 * Document-post display options (asset rides on media[]).
+                 */
+                document?: {
+                    /**
+                     * Display title shown above the document. Required for document posts.
+                     */
+                    title: string;
+                };
+                /**
+                 * Disable resharing of this post (default false).
+                 */
+                disable_reshare?: boolean;
+                /**
+                 * Inline @mentions encoded into the commentary at publish.
+                 */
+                mentions?: Array<{
+                    /**
+                     * Whether the mentioned entity is a member or an organization.
+                     */
+                    type: 'person' | 'organization';
+                    /**
+                     * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                     */
+                    name: string;
+                    /**
+                     * The mentioned entity urn (supplied by the caller).
+                     */
+                    urn: string;
+                }>;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
+            /**
+             * Facebook Page organic post settings.
+             */
+            settings: {
+                /**
+                 * URL to unfurl. A feed post needs a body (message) OR a link.
+                 */
+                link?: string;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
+            /**
+             * Instagram organic post settings (feed image/carousel + reels).
+             */
+            settings: {
+                /**
+                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
+                 */
+                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
+                /**
+                 * Facebook Page id representing a location.
+                 */
+                location_id?: string;
+                /**
+                 * Tag users on an image; x/y are fractional positions in [0,1].
+                 */
+                user_tags?: Array<{
+                    /**
+                     * IG username to tag.
+                     */
+                    username: string;
+                    /**
+                     * Horizontal position on the image, in [0,1].
+                     */
+                    x: number;
+                    /**
+                     * Vertical position on the image, in [0,1].
+                     */
+                    y: number;
+                }>;
+                /**
+                 * ≤3 co-author usernames.
+                 */
+                collaborators?: Array<string>;
+                /**
+                 * Reel also appears in the main feed.
+                 */
+                share_to_feed?: boolean;
+                /**
+                 * Reel cover frame offset (ms).
+                 */
+                thumb_offset?: number;
+                /**
+                 * Custom reel cover image URL.
+                 */
+                cover_url?: string;
+                /**
+                 * Label for the reel's original audio.
+                 */
+                audio_name?: string;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
+            /**
+             * TikTok organic post settings (Direct Post: video + photo).
+             */
+            settings: {
+                /**
+                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 */
+                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                /**
+                 * Disable comments on this post.
+                 */
+                disable_comment?: boolean;
+                /**
+                 * Disable Duet (video only).
+                 */
+                disable_duet?: boolean;
+                /**
+                 * Disable Stitch (video only).
+                 */
+                disable_stitch?: boolean;
+                /**
+                 * Video cover frame offset (ms). Video posts only.
+                 */
+                video_cover_timestamp_ms?: number;
+                /**
+                 * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                 */
+                photo_cover_index?: number;
+                /**
+                 * Auto-add a TikTok soundtrack. Photo posts only.
+                 */
+                auto_add_music?: boolean;
+                /**
+                 * Disclose a paid partnership (branded content).
+                 */
+                brand_content_toggle?: boolean;
+                /**
+                 * Disclose own-brand promotional content.
+                 */
+                brand_organic_toggle?: boolean;
+                /**
+                 * Disclose AI-generated content. Video posts only.
+                 */
+                is_aigc?: boolean;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        }>;
+        /**
+         * ISO-8601 creation time.
+         */
+        created_at: string;
+        /**
+         * ISO-8601 last-update time.
+         */
+        updated_at: string;
+        /**
+         * Whether this was a validate-only dry run.
+         */
+        dry_run: boolean;
+        /**
+         * Whether the post was actually persisted (false on a dry run).
+         */
+        executed: boolean;
+    };
+};
+type PostsCreateResponse = PostsCreateResponses[keyof PostsCreateResponses];
+type PostsDeleteData = {
+    body?: never;
+    path: {
+        /**
+         * The post id.
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/posts/{id}';
+};
+type PostsDeleteErrors = {
+    /**
+     * An RFC 9457 problem response.
+     */
+    400: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'idempotency_key_invalid';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    401: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'unauthorized';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    403: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'forbidden';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    404: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'not_found';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    409: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'conflict' | 'idempotency_request_in_progress';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    422: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'idempotency_key_reused';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    429: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'rate_limited';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+};
+type PostsDeleteError = PostsDeleteErrors[keyof PostsDeleteErrors];
+type PostsDeleteResponses = {
+    /**
+     * OK
+     */
+    200: {
+        id: string;
+        object: 'post';
+        deleted: true;
+    };
+};
+type PostsDeleteResponse = PostsDeleteResponses[keyof PostsDeleteResponses];
+type PostsGetData = {
+    body?: never;
+    path: {
+        /**
+         * The post id.
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/posts/{id}';
+};
+type PostsGetErrors = {
+    /**
+     * An RFC 9457 problem response.
+     */
+    400: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'idempotency_key_invalid';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
          * The request id, for support and log correlation.
          */
         request_id?: string;
@@ -6372,58 +7456,969 @@ type PostsDeleteErrors = {
          */
         code: 'idempotency_key_reused';
         /**
-         * An occurrence-specific, human-readable explanation.
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+    /**
+     * An RFC 9457 problem response.
+     */
+    429: {
+        /**
+         * A URL to this code's documentation page.
+         */
+        type: string;
+        /**
+         * A stable, human-readable summary of the error code.
+         */
+        title: string;
+        /**
+         * The HTTP status code.
+         */
+        status: number;
+        /**
+         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
+         */
+        code: 'rate_limited';
+        /**
+         * An occurrence-specific, human-readable explanation.
+         */
+        detail?: string;
+        /**
+         * The request id, for support and log correlation.
+         */
+        request_id?: string;
+    };
+};
+type PostsGetError = PostsGetErrors[keyof PostsGetErrors];
+type PostsGetResponses = {
+    /**
+     * OK
+     */
+    200: {
+        id: string;
+        object: 'post';
+        profile_id: string;
+        external_id: string | null;
+        /**
+         * Derived rollup of the variants’ statuses (never set directly).
+         */
+        status: 'draft' | 'scheduled' | 'publishing' | 'partially_published' | 'published' | 'failed';
+        /**
+         * Shared schedule (ISO-8601). null = draft/publish-now.
+         */
+        schedule_at: string | null;
+        tags: Array<string>;
+        notes: string | null;
+        /**
+         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
+         */
+        metadata: {
+            [key: string]: string | number | boolean;
+        };
+        variants: Array<{
+            platform: 'x';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * X (Twitter) organic post settings.
+             */
+            settings: {
+                /**
+                 * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
+                 */
+                reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                /**
+                 * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
+                 */
+                quote_tweet_id?: string;
+                /**
+                 * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                 */
+                poll?: {
+                    /**
+                     * 2–4 options, each 1–25 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * Poll duration in minutes (5 min – 7 days).
+                     */
+                    duration_minutes: number;
+                    /**
+                     * Reply restriction for the poll post (same enum).
+                     */
+                    reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                };
+                /**
+                 * Reply/thread chaining controls.
+                 */
+                reply?: {
+                    /**
+                     * Parent post id; required when `reply` is present.
+                     */
+                    in_reply_to_tweet_id: string;
+                    /**
+                     * User ids dropped from the auto-mention chain.
+                     */
+                    exclude_reply_user_ids?: Array<string>;
+                    /**
+                     * Auto-prepend the parent participants' @mentions.
+                     */
+                    auto_populate_reply_metadata?: boolean;
+                };
+                /**
+                 * Post to an X Community.
+                 */
+                community_id?: string;
+                /**
+                 * Restrict to Super Followers (default false).
+                 */
+                for_super_followers_only?: boolean;
+                /**
+                 * Attach a place.
+                 */
+                geo?: {
+                    place_id: string;
+                };
+                /**
+                 * Cards-API reference. Mutually exclusive with quote/poll/media.
+                 */
+                card_uri?: string;
+                /**
+                 * Tag ≤10 users on attached media.
+                 */
+                media_tagged_user_ids?: Array<string>;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * LinkedIn personal member post settings.
+             */
+            settings: {
+                /**
+                 * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
+                 */
+                visibility: 'PUBLIC' | 'CONNECTIONS';
+                /**
+                 * Which content shape this post carries (mutually exclusive with the others).
+                 */
+                content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
+                /**
+                 * An article share card.
+                 */
+                article?: {
+                    /**
+                     * Article URL. Required for an article post.
+                     */
+                    source: string;
+                    /**
+                     * Article headline, ≤400 characters.
+                     */
+                    title?: string;
+                    /**
+                     * Subtext on the article card, ≤4086 characters.
+                     */
+                    description?: string;
+                    /**
+                     * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                     */
+                    thumbnail_media_id?: string;
+                };
+                /**
+                 * A LinkedIn poll (mutually exclusive with other content).
+                 */
+                poll?: {
+                    /**
+                     * The poll question, ≤140 characters.
+                     */
+                    question: string;
+                    /**
+                     * 2–4 options, each 1–30 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * How long the poll runs.
+                     */
+                    duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
+                };
+                /**
+                 * Document-post display options (asset rides on media[]).
+                 */
+                document?: {
+                    /**
+                     * Display title shown above the document. Required for document posts.
+                     */
+                    title: string;
+                };
+                /**
+                 * Disable resharing of this post (default false).
+                 */
+                disable_reshare?: boolean;
+                /**
+                 * Inline @mentions encoded into the commentary at publish.
+                 */
+                mentions?: Array<{
+                    /**
+                     * Whether the mentioned entity is a member or an organization.
+                     */
+                    type: 'person' | 'organization';
+                    /**
+                     * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                     */
+                    name: string;
+                    /**
+                     * The mentioned entity urn (supplied by the caller).
+                     */
+                    urn: string;
+                }>;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
+            /**
+             * Facebook Page organic post settings.
+             */
+            settings: {
+                /**
+                 * URL to unfurl. A feed post needs a body (message) OR a link.
+                 */
+                link?: string;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
+            /**
+             * Instagram organic post settings (feed image/carousel + reels).
+             */
+            settings: {
+                /**
+                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
+                 */
+                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
+                /**
+                 * Facebook Page id representing a location.
+                 */
+                location_id?: string;
+                /**
+                 * Tag users on an image; x/y are fractional positions in [0,1].
+                 */
+                user_tags?: Array<{
+                    /**
+                     * IG username to tag.
+                     */
+                    username: string;
+                    /**
+                     * Horizontal position on the image, in [0,1].
+                     */
+                    x: number;
+                    /**
+                     * Vertical position on the image, in [0,1].
+                     */
+                    y: number;
+                }>;
+                /**
+                 * ≤3 co-author usernames.
+                 */
+                collaborators?: Array<string>;
+                /**
+                 * Reel also appears in the main feed.
+                 */
+                share_to_feed?: boolean;
+                /**
+                 * Reel cover frame offset (ms).
+                 */
+                thumb_offset?: number;
+                /**
+                 * Custom reel cover image URL.
+                 */
+                cover_url?: string;
+                /**
+                 * Label for the reel's original audio.
+                 */
+                audio_name?: string;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
+            /**
+             * TikTok organic post settings (Direct Post: video + photo).
+             */
+            settings: {
+                /**
+                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 */
+                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                /**
+                 * Disable comments on this post.
+                 */
+                disable_comment?: boolean;
+                /**
+                 * Disable Duet (video only).
+                 */
+                disable_duet?: boolean;
+                /**
+                 * Disable Stitch (video only).
+                 */
+                disable_stitch?: boolean;
+                /**
+                 * Video cover frame offset (ms). Video posts only.
+                 */
+                video_cover_timestamp_ms?: number;
+                /**
+                 * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                 */
+                photo_cover_index?: number;
+                /**
+                 * Auto-add a TikTok soundtrack. Photo posts only.
+                 */
+                auto_add_music?: boolean;
+                /**
+                 * Disclose a paid partnership (branded content).
+                 */
+                brand_content_toggle?: boolean;
+                /**
+                 * Disclose own-brand promotional content.
+                 */
+                brand_organic_toggle?: boolean;
+                /**
+                 * Disclose AI-generated content. Video posts only.
+                 */
+                is_aigc?: boolean;
+            };
+            id: string;
+            object: 'post_variant';
+            /**
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
+             */
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
+            /**
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        }>;
+        /**
+         * ISO-8601 creation time.
          */
-        detail?: string;
+        created_at: string;
         /**
-         * The request id, for support and log correlation.
+         * ISO-8601 last-update time.
          */
-        request_id?: string;
+        updated_at: string;
     };
-    /**
-     * An RFC 9457 problem response.
-     */
-    429: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'rate_limited';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
+};
+type PostsGetResponse = PostsGetResponses[keyof PostsGetResponses];
+type PostsUpdateData = {
+    body?: {
+        publish?: 'now' | 'schedule' | 'draft';
+        schedule_at?: string | null;
+        external_id?: string | null;
         /**
-         * The request id, for support and log correlation.
+         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
          */
-        request_id?: string;
-    };
-};
-type PostsDeleteError = PostsDeleteErrors[keyof PostsDeleteErrors];
-type PostsDeleteResponses = {
-    /**
-     * OK
-     */
-    200: {
-        id: string;
-        object: 'post';
-        deleted: true;
+        metadata?: {
+            [key: string]: string | number | boolean;
+        };
+        tags?: Array<string>;
+        notes?: string | null;
+        dry_run?: boolean;
+        /**
+         * A single platform variant of a post: connection, platform, explicit post_type, body, ordered media, and native typed settings.
+         */
+        variants?: Array<{
+            platform: 'x';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * X (Twitter) organic post settings.
+             */
+            settings?: {
+                /**
+                 * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
+                 */
+                reply_settings?: 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                /**
+                 * Quote a post by id. Mutually exclusive with poll/card_uri/media. Enterprise-tier at publish.
+                 */
+                quote_tweet_id?: string;
+                /**
+                 * Create a poll. Mutually exclusive with media, quote, and card_uri.
+                 */
+                poll?: {
+                    /**
+                     * 2–4 options, each 1–25 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * Poll duration in minutes (5 min – 7 days).
+                     */
+                    duration_minutes: number;
+                    /**
+                     * Reply restriction for the poll post (same enum).
+                     */
+                    reply_settings?: 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
+                };
+                /**
+                 * Reply/thread chaining controls.
+                 */
+                reply?: {
+                    /**
+                     * Parent post id; required when `reply` is present.
+                     */
+                    in_reply_to_tweet_id: string;
+                    /**
+                     * User ids dropped from the auto-mention chain.
+                     */
+                    exclude_reply_user_ids?: Array<string>;
+                    /**
+                     * Auto-prepend the parent participants' @mentions.
+                     */
+                    auto_populate_reply_metadata?: boolean;
+                };
+                /**
+                 * Post to an X Community.
+                 */
+                community_id?: string;
+                /**
+                 * Restrict to Super Followers (default false).
+                 */
+                for_super_followers_only?: boolean;
+                /**
+                 * Attach a place.
+                 */
+                geo?: {
+                    place_id: string;
+                };
+                /**
+                 * Cards-API reference. Mutually exclusive with quote/poll/media.
+                 */
+                card_uri?: string;
+                /**
+                 * Tag ≤10 users on attached media.
+                 */
+                media_tagged_user_ids?: Array<string>;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
+            /**
+             * LinkedIn personal member post settings.
+             */
+            settings: {
+                /**
+                 * Audience. PUBLIC or CONNECTIONS — CONTAINER/LOGGED_IN are invalid for member posts.
+                 */
+                visibility: 'PUBLIC' | 'CONNECTIONS';
+                /**
+                 * Which content shape this post carries (mutually exclusive with the others).
+                 */
+                content_kind: 'text' | 'single_image' | 'video' | 'multi_image' | 'document' | 'article' | 'poll';
+                /**
+                 * An article share card.
+                 */
+                article?: {
+                    /**
+                     * Article URL. Required for an article post.
+                     */
+                    source: string;
+                    /**
+                     * Article headline, ≤400 characters.
+                     */
+                    title?: string;
+                    /**
+                     * Subtext on the article card, ≤4086 characters.
+                     */
+                    description?: string;
+                    /**
+                     * Optional thumbnail, referenced by OUR media id (resolved to a urn:li:image at publish).
+                     */
+                    thumbnail_media_id?: string;
+                };
+                /**
+                 * A LinkedIn poll (mutually exclusive with other content).
+                 */
+                poll?: {
+                    /**
+                     * The poll question, ≤140 characters.
+                     */
+                    question: string;
+                    /**
+                     * 2–4 options, each 1–30 characters.
+                     */
+                    options: Array<string>;
+                    /**
+                     * How long the poll runs.
+                     */
+                    duration: 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS';
+                };
+                /**
+                 * Document-post display options (asset rides on media[]).
+                 */
+                document?: {
+                    /**
+                     * Display title shown above the document. Required for document posts.
+                     */
+                    title: string;
+                };
+                /**
+                 * Disable resharing of this post (default false).
+                 */
+                disable_reshare?: boolean;
+                /**
+                 * Inline @mentions encoded into the commentary at publish.
+                 */
+                mentions?: Array<{
+                    /**
+                     * Whether the mentioned entity is a member or an organization.
+                     */
+                    type: 'person' | 'organization';
+                    /**
+                     * Rendered text; must match the entity name (case-sensitive) for the link to convert.
+                     */
+                    name: string;
+                    /**
+                     * The mentioned entity urn (supplied by the caller).
+                     */
+                    urn: string;
+                }>;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
+            /**
+             * Instagram organic post settings (feed image/carousel + reels).
+             */
+            settings: {
+                /**
+                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
+                 */
+                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
+                /**
+                 * Facebook Page id representing a location.
+                 */
+                location_id?: string;
+                /**
+                 * Tag users on an image; x/y are fractional positions in [0,1].
+                 */
+                user_tags?: Array<{
+                    /**
+                     * IG username to tag.
+                     */
+                    username: string;
+                    /**
+                     * Horizontal position on the image, in [0,1].
+                     */
+                    x: number;
+                    /**
+                     * Vertical position on the image, in [0,1].
+                     */
+                    y: number;
+                }>;
+                /**
+                 * ≤3 co-author usernames.
+                 */
+                collaborators?: Array<string>;
+                /**
+                 * Reel also appears in the main feed.
+                 */
+                share_to_feed?: boolean;
+                /**
+                 * Reel cover frame offset (ms).
+                 */
+                thumb_offset?: number;
+                /**
+                 * Custom reel cover image URL.
+                 */
+                cover_url?: string;
+                /**
+                 * Label for the reel's original audio.
+                 */
+                audio_name?: string;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
+            /**
+             * Facebook Page organic post settings.
+             */
+            settings?: {
+                /**
+                 * URL to unfurl. A feed post needs a body (message) OR a link.
+                 */
+                link?: string;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
+            /**
+             * TikTok organic post settings (Direct Post: video + photo).
+             */
+            settings?: {
+                /**
+                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 */
+                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                /**
+                 * Disable comments on this post.
+                 */
+                disable_comment?: boolean;
+                /**
+                 * Disable Duet (video only).
+                 */
+                disable_duet?: boolean;
+                /**
+                 * Disable Stitch (video only).
+                 */
+                disable_stitch?: boolean;
+                /**
+                 * Video cover frame offset (ms). Video posts only.
+                 */
+                video_cover_timestamp_ms?: number;
+                /**
+                 * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                 */
+                photo_cover_index?: number;
+                /**
+                 * Auto-add a TikTok soundtrack. Photo posts only.
+                 */
+                auto_add_music?: boolean;
+                /**
+                 * Disclose a paid partnership (branded content).
+                 */
+                brand_content_toggle?: boolean;
+                /**
+                 * Disclose own-brand promotional content.
+                 */
+                brand_organic_toggle?: boolean;
+                /**
+                 * Disclose AI-generated content. Video posts only.
+                 */
+                is_aigc?: boolean;
+            };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
+        }>;
     };
-};
-type PostsDeleteResponse = PostsDeleteResponses[keyof PostsDeleteResponses];
-type PostsGetData = {
-    body?: never;
     path: {
         /**
          * The post id.
@@ -6433,7 +8428,7 @@ type PostsGetData = {
     query?: never;
     url: '/posts/{id}';
 };
-type PostsGetErrors = {
+type PostsUpdateErrors = {
     /**
      * An RFC 9457 problem response.
      */
@@ -6598,7 +8593,7 @@ type PostsGetErrors = {
         /**
          * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
          */
-        code: 'idempotency_key_reused';
+        code: 'idempotency_key_reused' | 'invalid_connection' | 'invalid_media' | 'internal_error' | 'not_publishable';
         /**
          * An occurrence-specific, human-readable explanation.
          */
@@ -6607,6 +8602,35 @@ type PostsGetErrors = {
          * The request id, for support and log correlation.
          */
         request_id?: string;
+        /**
+         * The specific fields that failed validation or publish-readiness.
+         */
+        errors?: Array<{
+            /**
+             * Dot-path to the invalid field, e.g. `variants.0.body`.
+             */
+            field: string;
+            /**
+             * The validation or publish-readiness rule that failed.
+             */
+            code: string;
+            /**
+             * What is wrong with this field.
+             */
+            detail: string;
+            /**
+             * How to fix it (publish-readiness failures).
+             */
+            hint?: string;
+            /**
+             * The accepted value(s) for this field, when known.
+             */
+            allowed?: Array<string>;
+            /**
+             * The value received, when known.
+             */
+            got?: string;
+        }>;
     };
     /**
      * An RFC 9457 problem response.
@@ -6638,8 +8662,8 @@ type PostsGetErrors = {
         request_id?: string;
     };
 };
-type PostsGetError = PostsGetErrors[keyof PostsGetErrors];
-type PostsGetResponses = {
+type PostsUpdateError = PostsUpdateErrors[keyof PostsUpdateErrors];
+type PostsUpdateResponses = {
     /**
      * OK
      */
@@ -6654,127 +8678,23 @@ type PostsGetResponses = {
         status: 'draft' | 'scheduled' | 'publishing' | 'partially_published' | 'published' | 'failed';
         /**
          * Shared schedule (ISO-8601). null = draft/publish-now.
-         */
-        schedule_at: string | null;
-        tags: Array<string>;
-        notes: string | null;
-        /**
-         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
-         */
-        metadata: {
-            [key: string]: string | number | boolean;
-        };
-        variants: Array<{
-            id: string;
-            object: 'post_variant';
-            /**
-             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
-             */
-            connection_id: string | null;
-            platform: 'x' | 'linkedin' | 'facebook_page' | 'instagram' | 'tiktok';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video' | 'reel' | 'carousel';
-            body: string | null;
-            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
-            /**
-             * Native per-platform settings, as stored.
-             */
-            settings: {
-                [key: string]: unknown;
-            };
-            /**
-             * Per-variant schedule override (ISO-8601); null inherits the post.
-             */
-            schedule_at: string | null;
-            result: {
-                platform_post_id: string;
-                permalink: string | null;
-                published_at: string;
-            } | null;
-            error: {
-                code: string;
-                message: string;
-                /**
-                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
-                 */
-                display_error: string;
-            } | null;
-            media: Array<{
-                media_id: string;
-                /**
-                 * Ordering of this media within the variant (e.g. carousel order).
-                 */
-                position: number;
-                /**
-                 * Per-variant crop, applied at publish; null = none.
-                 */
-                crop_box: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset’s alt_text.
-                 */
-                alt_text_override: string | null;
-            }>;
-        }>;
-        /**
-         * ISO-8601 creation time.
-         */
-        created_at: string;
-        /**
-         * ISO-8601 last-update time.
-         */
-        updated_at: string;
-    };
-};
-type PostsGetResponse = PostsGetResponses[keyof PostsGetResponses];
-type PostsUpdateData = {
-    body?: {
-        publish?: 'now' | 'schedule' | 'draft';
-        schedule_at?: string | null;
-        external_id?: string | null;
+         */
+        schedule_at: string | null;
+        tags: Array<string>;
+        notes: string | null;
         /**
          * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
          */
-        metadata?: {
+        metadata: {
             [key: string]: string | number | boolean;
         };
-        tags?: Array<string>;
-        notes?: string | null;
-        dry_run?: boolean;
-        /**
-         * A single platform variant of a post: connection, platform, explicit post_type, body, ordered media, and native typed settings.
-         */
-        variants?: Array<{
+        variants: Array<{
             platform: 'x';
             post_type: 'text' | 'single_image' | 'multi_image' | 'video';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
             /**
              * X (Twitter) organic post settings.
              */
-            settings?: {
+            settings: {
                 /**
                  * Who may reply. Omit (or `everyone`) = anyone. `everyone` is sugar that is normalised to an omitted field.
                  */
@@ -6840,33 +8760,51 @@ type PostsUpdateData = {
                  */
                 media_tagged_user_ids?: Array<string>;
             };
-        } | {
-            platform: 'linkedin';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
+            id: string;
+            object: 'post_variant';
             /**
-             * Caption / commentary / message for the post.
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
-            body?: string;
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
             /**
-             * Ordered media references; the count drives the post-type rules.
+             * Per-variant schedule override (ISO-8601); null inherits the post.
              */
-            media?: Array<{
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
                 media_id: string;
                 /**
-                 * Per-variant crop applied at publish; omit for none.
+                 * Ordering of this media within the variant (e.g. carousel order).
                  */
-                crop_box?: {
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
                     [key: string]: unknown;
                 } | null;
                 /**
-                 * Per-variant alt text; falls back to the asset's.
+                 * Per-variant alt text; falls back to the asset’s alt_text.
                  */
-                alt_text_override?: string | null;
+                alt_text_override: string | null;
             }>;
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
             /**
              * LinkedIn personal member post settings.
              */
@@ -6948,479 +8886,253 @@ type PostsUpdateData = {
                     urn: string;
                 }>;
             };
-        } | {
-            platform: 'instagram';
-            post_type: 'single_image' | 'carousel' | 'reel';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
+            id: string;
+            object: 'post_variant';
             /**
-             * Ordered media references; the count drives the post-type rules.
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
             /**
-             * Instagram organic post settings (feed image/carousel + reels).
+             * Per-variant schedule override (ISO-8601); null inherits the post.
              */
-            settings: {
-                /**
-                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
-                 */
-                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
-                /**
-                 * Facebook Page id representing a location.
-                 */
-                location_id?: string;
-                /**
-                 * Tag users on an image; x/y are fractional positions in [0,1].
-                 */
-                user_tags?: Array<{
-                    /**
-                     * IG username to tag.
-                     */
-                    username: string;
-                    /**
-                     * Horizontal position on the image, in [0,1].
-                     */
-                    x: number;
-                    /**
-                     * Vertical position on the image, in [0,1].
-                     */
-                    y: number;
-                }>;
-                /**
-                 * ≤3 co-author usernames.
-                 */
-                collaborators?: Array<string>;
-                /**
-                 * Reel also appears in the main feed.
-                 */
-                share_to_feed?: boolean;
-                /**
-                 * Reel cover frame offset (ms).
-                 */
-                thumb_offset?: number;
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
                 /**
-                 * Custom reel cover image URL.
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
                  */
-                cover_url?: string;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
                 /**
-                 * Label for the reel's original audio.
+                 * Ordering of this media within the variant (e.g. carousel order).
                  */
-                audio_name?: string;
-            };
-        } | {
-            platform: 'facebook_page';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
+                position: number;
                 /**
-                 * Per-variant crop applied at publish; omit for none.
+                 * Per-variant crop, applied at publish; null = none.
                  */
-                crop_box?: {
+                crop_box: {
                     [key: string]: unknown;
                 } | null;
                 /**
-                 * Per-variant alt text; falls back to the asset's.
+                 * Per-variant alt text; falls back to the asset’s alt_text.
                  */
-                alt_text_override?: string | null;
+                alt_text_override: string | null;
             }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
             /**
              * Facebook Page organic post settings.
              */
-            settings?: {
+            settings: {
                 /**
                  * URL to unfurl. A feed post needs a body (message) OR a link.
                  */
                 link?: string;
             };
-        } | {
-            platform: 'tiktok';
-            post_type: 'video' | 'single_image' | 'carousel';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
+            id: string;
+            object: 'post_variant';
             /**
-             * Ordered media references; the count drives the post-type rules.
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
             /**
-             * TikTok organic post settings (Direct Post: video + photo).
-             */
-            settings?: {
-                /**
-                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
-                 */
-                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
-                /**
-                 * Disable comments on this post.
-                 */
-                disable_comment?: boolean;
-                /**
-                 * Disable Duet (video only).
-                 */
-                disable_duet?: boolean;
+             * Per-variant schedule override (ISO-8601); null inherits the post.
+             */
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
                 /**
-                 * Disable Stitch (video only).
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
                  */
-                disable_stitch?: boolean;
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
                 /**
-                 * Video cover frame offset (ms). Video posts only.
+                 * Ordering of this media within the variant (e.g. carousel order).
                  */
-                video_cover_timestamp_ms?: number;
+                position: number;
                 /**
-                 * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                 * Per-variant crop, applied at publish; null = none.
                  */
-                photo_cover_index?: number;
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
                 /**
-                 * Auto-add a TikTok soundtrack. Photo posts only.
+                 * Per-variant alt text; falls back to the asset’s alt_text.
                  */
-                auto_add_music?: boolean;
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
+            /**
+             * Instagram organic post settings (feed image/carousel + reels).
+             */
+            settings: {
                 /**
-                 * Disclose a paid partnership (branded content).
+                 * Feed image, carousel, or reel. Defaults to IMAGE for a single image.
                  */
-                brand_content_toggle?: boolean;
+                media_type?: 'IMAGE' | 'CAROUSEL' | 'REELS';
                 /**
-                 * Disclose own-brand promotional content.
+                 * Facebook Page id representing a location.
                  */
-                brand_organic_toggle?: boolean;
+                location_id?: string;
                 /**
-                 * Disclose AI-generated content. Video posts only.
+                 * Tag users on an image; x/y are fractional positions in [0,1].
                  */
-                is_aigc?: boolean;
-            };
-        }>;
-    };
-    path: {
-        /**
-         * The post id.
-         */
-        id: string;
-    };
-    query?: never;
-    url: '/posts/{id}';
-};
-type PostsUpdateErrors = {
-    /**
-     * An RFC 9457 problem response.
-     */
-    400: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'idempotency_key_invalid';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    401: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'unauthorized';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    403: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'forbidden';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    404: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'not_found';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    409: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'conflict' | 'idempotency_request_in_progress';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    422: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'idempotency_key_reused' | 'invalid_connection' | 'invalid_media' | 'internal_error' | 'not_publishable';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-        /**
-         * The specific fields that failed validation or publish-readiness.
-         */
-        errors?: Array<{
-            /**
-             * Dot-path to the invalid field, e.g. `variants.0.body`.
-             */
-            field: string;
-            /**
-             * The validation or publish-readiness rule that failed.
-             */
-            code: string;
-            /**
-             * What is wrong with this field.
-             */
-            detail: string;
+                user_tags?: Array<{
+                    /**
+                     * IG username to tag.
+                     */
+                    username: string;
+                    /**
+                     * Horizontal position on the image, in [0,1].
+                     */
+                    x: number;
+                    /**
+                     * Vertical position on the image, in [0,1].
+                     */
+                    y: number;
+                }>;
+                /**
+                 * ≤3 co-author usernames.
+                 */
+                collaborators?: Array<string>;
+                /**
+                 * Reel also appears in the main feed.
+                 */
+                share_to_feed?: boolean;
+                /**
+                 * Reel cover frame offset (ms).
+                 */
+                thumb_offset?: number;
+                /**
+                 * Custom reel cover image URL.
+                 */
+                cover_url?: string;
+                /**
+                 * Label for the reel's original audio.
+                 */
+                audio_name?: string;
+            };
+            id: string;
+            object: 'post_variant';
             /**
-             * How to fix it (publish-readiness failures).
+             * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
-            hint?: string;
+            connection_id: string | null;
+            body: string | null;
+            status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
             /**
-             * The accepted value(s) for this field, when known.
+             * Per-variant schedule override (ISO-8601); null inherits the post.
              */
-            allowed?: Array<string>;
+            schedule_at: string | null;
+            result: {
+                platform_post_id: string;
+                permalink: string | null;
+                published_at: string;
+            } | null;
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * A short, friendly end-user line for `code` (render verbatim). `message` stays developer-grade; this is the display string.
+                 */
+                display_error: string;
+            } | null;
+            media: Array<{
+                media_id: string;
+                /**
+                 * Ordering of this media within the variant (e.g. carousel order).
+                 */
+                position: number;
+                /**
+                 * Per-variant crop, applied at publish; null = none.
+                 */
+                crop_box: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset’s alt_text.
+                 */
+                alt_text_override: string | null;
+            }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
             /**
-             * The value received, when known.
+             * TikTok organic post settings (Direct Post: video + photo).
              */
-            got?: string;
-        }>;
-    };
-    /**
-     * An RFC 9457 problem response.
-     */
-    429: {
-        /**
-         * A URL to this code's documentation page.
-         */
-        type: string;
-        /**
-         * A stable, human-readable summary of the error code.
-         */
-        title: string;
-        /**
-         * The HTTP status code.
-         */
-        status: number;
-        /**
-         * The machine-readable error code — branch on this. Narrowed to the codes this endpoint can return at this status.
-         */
-        code: 'rate_limited';
-        /**
-         * An occurrence-specific, human-readable explanation.
-         */
-        detail?: string;
-        /**
-         * The request id, for support and log correlation.
-         */
-        request_id?: string;
-    };
-};
-type PostsUpdateError = PostsUpdateErrors[keyof PostsUpdateErrors];
-type PostsUpdateResponses = {
-    /**
-     * OK
-     */
-    200: {
-        id: string;
-        object: 'post';
-        profile_id: string;
-        external_id: string | null;
-        /**
-         * Derived rollup of the variants’ statuses (never set directly).
-         */
-        status: 'draft' | 'scheduled' | 'publishing' | 'partially_published' | 'published' | 'failed';
-        /**
-         * Shared schedule (ISO-8601). null = draft/publish-now.
-         */
-        schedule_at: string | null;
-        tags: Array<string>;
-        notes: string | null;
-        /**
-         * Customer-owned key/value context, returned on reads and filterable on list endpoints (exact match). Values are scalars: string (≤500 chars), number, or boolean. At most 50 keys; keys ≤40 chars; total serialized JSON must fit in 16 KiB. Arrays and nested objects are out of scope for v1 (kept out to keep the contract scalar + exact-match). Keep a key’s value type consistent across records — filtering matches type-exactly. Never derive auth/scopes from metadata.
-         */
-        metadata: {
-            [key: string]: string | number | boolean;
-        };
-        variants: Array<{
+            settings: {
+                /**
+                 * Audience for the post. The per-account allowed set is returned by creator_info at publish; an out-of-set value is rejected then. Unaudited apps may only use SELF_ONLY.
+                 */
+                privacy_level?: 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' | 'SELF_ONLY';
+                /**
+                 * Disable comments on this post.
+                 */
+                disable_comment?: boolean;
+                /**
+                 * Disable Duet (video only).
+                 */
+                disable_duet?: boolean;
+                /**
+                 * Disable Stitch (video only).
+                 */
+                disable_stitch?: boolean;
+                /**
+                 * Video cover frame offset (ms). Video posts only.
+                 */
+                video_cover_timestamp_ms?: number;
+                /**
+                 * Which carousel image is the cover (0-based index into the ordered image list). Photo posts only.
+                 */
+                photo_cover_index?: number;
+                /**
+                 * Auto-add a TikTok soundtrack. Photo posts only.
+                 */
+                auto_add_music?: boolean;
+                /**
+                 * Disclose a paid partnership (branded content).
+                 */
+                brand_content_toggle?: boolean;
+                /**
+                 * Disclose own-brand promotional content.
+                 */
+                brand_organic_toggle?: boolean;
+                /**
+                 * Disclose AI-generated content. Video posts only.
+                 */
+                is_aigc?: boolean;
+            };
             id: string;
             object: 'post_variant';
             /**
              * The connected account this variant publishes to. null when that connection was removed (disconnected) — the variant then fails at publish time with a `connection_removed` error; reconnect + reschedule to resume.
              */
             connection_id: string | null;
-            platform: 'x' | 'linkedin' | 'facebook_page' | 'instagram' | 'tiktok';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video' | 'reel' | 'carousel';
             body: string | null;
             status: 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed';
-            /**
-             * Native per-platform settings, as stored.
-             */
-            settings: {
-                [key: string]: unknown;
-            };
             /**
              * Per-variant schedule override (ISO-8601); null inherits the post.
              */
@@ -7487,30 +9199,6 @@ type PostsValidateData = {
         variants: Array<{
             platform: 'x';
             post_type: 'text' | 'single_image' | 'multi_image' | 'video';
-            /**
-             * The connected account this variant publishes to.
-             */
-            connection_id: string;
-            /**
-             * Caption / commentary / message for the post.
-             */
-            body?: string;
-            /**
-             * Ordered media references; the count drives the post-type rules.
-             */
-            media?: Array<{
-                media_id: string;
-                /**
-                 * Per-variant crop applied at publish; omit for none.
-                 */
-                crop_box?: {
-                    [key: string]: unknown;
-                } | null;
-                /**
-                 * Per-variant alt text; falls back to the asset's.
-                 */
-                alt_text_override?: string | null;
-            }>;
             /**
              * X (Twitter) organic post settings.
              */
@@ -7580,9 +9268,6 @@ type PostsValidateData = {
                  */
                 media_tagged_user_ids?: Array<string>;
             };
-        } | {
-            platform: 'linkedin';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
             /**
              * The connected account this variant publishes to.
              */
@@ -7607,6 +9292,9 @@ type PostsValidateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'linkedin';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'video';
             /**
              * LinkedIn personal member post settings.
              */
@@ -7688,9 +9376,6 @@ type PostsValidateData = {
                     urn: string;
                 }>;
             };
-        } | {
-            platform: 'instagram';
-            post_type: 'single_image' | 'carousel' | 'reel';
             /**
              * The connected account this variant publishes to.
              */
@@ -7715,6 +9400,9 @@ type PostsValidateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'instagram';
+            post_type: 'single_image' | 'carousel' | 'reel';
             /**
              * Instagram organic post settings (feed image/carousel + reels).
              */
@@ -7765,9 +9453,6 @@ type PostsValidateData = {
                  */
                 audio_name?: string;
             };
-        } | {
-            platform: 'facebook_page';
-            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
             /**
              * The connected account this variant publishes to.
              */
@@ -7792,6 +9477,9 @@ type PostsValidateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'facebook_page';
+            post_type: 'text' | 'single_image' | 'multi_image' | 'reel';
             /**
              * Facebook Page organic post settings.
              */
@@ -7801,9 +9489,6 @@ type PostsValidateData = {
                  */
                 link?: string;
             };
-        } | {
-            platform: 'tiktok';
-            post_type: 'video' | 'single_image' | 'carousel';
             /**
              * The connected account this variant publishes to.
              */
@@ -7828,6 +9513,9 @@ type PostsValidateData = {
                  */
                 alt_text_override?: string | null;
             }>;
+        } | {
+            platform: 'tiktok';
+            post_type: 'video' | 'single_image' | 'carousel';
             /**
              * TikTok organic post settings (Direct Post: video + photo).
              */
@@ -7873,6 +9561,30 @@ type PostsValidateData = {
                  */
                 is_aigc?: boolean;
             };
+            /**
+             * The connected account this variant publishes to.
+             */
+            connection_id: string;
+            /**
+             * Caption / commentary / message for the post.
+             */
+            body?: string;
+            /**
+             * Ordered media references; the count drives the post-type rules.
+             */
+            media?: Array<{
+                media_id: string;
+                /**
+                 * Per-variant crop applied at publish; omit for none.
+                 */
+                crop_box?: {
+                    [key: string]: unknown;
+                } | null;
+                /**
+                 * Per-variant alt text; falls back to the asset's.
+                 */
+                alt_text_override?: string | null;
+            }>;
         }>;
     };
     path?: never;