@lessly/sdk-app 97.4.0 → 98.0.0

package/dist/_types/gen/types.gen.d.ts

@@ -73830,6 +73830,159 @@ export interface ContentChannelsUpdateOutput {
      */
     deliveryMode: ("auto" | "reminder");
 }
+export interface ContentFoldersCreateInput {
+    /**
+     * The folder name, from 1 to 200 characters.
+     */
+    name: string;
+    /**
+     * Parent folder id, or null for a root folder. New folders go last among siblings.
+     */
+    parentId?: (string | null);
+}
+export interface ContentFoldersCreateOutput {
+    /**
+     * Folder id.
+     */
+    id: string;
+    /**
+     * Folder name.
+     */
+    name: string;
+    /**
+     * Parent folder id, or null at the root.
+     */
+    parentId: (string | null);
+    /**
+     * Order among siblings with the same parent.
+     */
+    position: number;
+    /**
+     * ISO-8601 creation time.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 time of the last change.
+     */
+    updatedAt: string;
+}
+export interface ContentFoldersDeleteInput {
+    /**
+     * A folder id from content_folders_list or content_folders_create.
+     */
+    folderId: string;
+}
+export interface ContentFoldersDeleteOutput {
+    /**
+     * True when this empty folder was deleted.
+     */
+    deleted: true;
+    /**
+     * A folder id from content_folders_list or content_folders_create.
+     */
+    folderId: string;
+}
+export interface ContentFoldersListInput {
+}
+export interface ContentFoldersListOutput {
+    /**
+     * Flat folder tree; parentId and position describe the hierarchy and order.
+     */
+    folders: {
+        /**
+         * Folder id.
+         */
+        id: string;
+        /**
+         * Folder name.
+         */
+        name: string;
+        /**
+         * Posts directly in this folder, by status.
+         */
+        counts: {
+            idea: number;
+            draft: number;
+            failed: number;
+            approved: number;
+            published: number;
+            scheduled: number;
+            pending_approval: number;
+        };
+        /**
+         * Parent folder id, or null at the root.
+         */
+        parentId: (string | null);
+        /**
+         * Order among siblings with the same parent.
+         */
+        position: number;
+        /**
+         * ISO-8601 creation time.
+         */
+        createdAt: string;
+        /**
+         * ISO-8601 time of the last change.
+         */
+        updatedAt: string;
+        /**
+         * Posts in this folder and all descendants, by status.
+         */
+        totalCounts: {
+            idea: number;
+            draft: number;
+            failed: number;
+            approved: number;
+            published: number;
+            scheduled: number;
+            pending_approval: number;
+        };
+    }[];
+}
+export interface ContentFoldersUpdateInput {
+    /**
+     * New folder name. Omit to keep it.
+     */
+    name?: string;
+    /**
+     * A folder id from content_folders_list or content_folders_create.
+     */
+    folderId: string;
+    /**
+     * New parent folder id, or null to move to the root. Omit to keep the current parent.
+     */
+    parentId?: (string | null);
+    /**
+     * Insert before this sibling in the target parent. Omit or set null to put the folder last.
+     */
+    beforeFolderId?: (string | null);
+}
+export interface ContentFoldersUpdateOutput {
+    /**
+     * Folder id.
+     */
+    id: string;
+    /**
+     * Folder name.
+     */
+    name: string;
+    /**
+     * Parent folder id, or null at the root.
+     */
+    parentId: (string | null);
+    /**
+     * Order among siblings with the same parent.
+     */
+    position: number;
+    /**
+     * ISO-8601 creation time.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 time of the last change.
+     */
+    updatedAt: string;
+}
 export interface ContentMediaCreateUploadUrlInput {
     /**
      * Name to store the file under, for display purposes.
@@ -74282,14 +74435,22 @@ export interface ContentPostsApproveOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -74313,6 +74474,14 @@ export interface ContentPostsApproveOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -74356,14 +74525,22 @@ export interface ContentPostsAttachMediaOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -74387,6 +74564,14 @@ export interface ContentPostsAttachMediaOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -74406,15 +74591,23 @@ export interface ContentPostsAttachMediaOutput {
 }
 export interface ContentPostsCreateInput {
     /**
-     * The post text, channel-independent, written in markdown — bold, italic, lists, links. Each network gets it flattened to the plain text that network accepts; content_publications_validate shows exactly what that looks like per channel. A target may override it for one network.
+     * Optional channel-independent markdown text. Omit or leave empty to create an idea with a title; with text, the post starts as a draft. A target may override this text for one network.
      */
-    text: string;
+    text?: string;
     /**
      * Media references attached to the post, in display order. Opaque strings — the toolkit does not upload or resolve them.
      *
      * @maxItems 20
      */
     media?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string];
+    /**
+     * Private plan notes, up to 20,000 characters. They are not published.
+     */
+    notes?: (string | null);
+    /**
+     * Optional plan title, up to 300 characters. Required when text is empty to create an idea.
+     */
+    title?: (string | null);
     /**
      * The networks this post is meant for, each with its variant: post type, optional text override and the network-specific fields. A post needs at least one target before it can be submitted, and it can only be scheduled to channels of these networks. Media is shared by every target.
      *
@@ -78641,6 +78834,10 @@ export interface ContentPostsCreateInput {
             postType?: string;
         }
     ];
+    /**
+     * Folder in this product to place the post in, or null for no folder. A new post goes last in that folder.
+     */
+    folderId?: (string | null);
 }
 export interface ContentPostsCreateOutput {
     /**
@@ -78655,14 +78852,22 @@ export interface ContentPostsCreateOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -78686,6 +78891,14 @@ export interface ContentPostsCreateOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -78703,6 +78916,22 @@ export interface ContentPostsCreateOutput {
      */
     approvedVersion: (number | null);
 }
+export interface ContentPostsDeleteInput {
+    /**
+     * The post id returned by content_posts_create.
+     */
+    postId: string;
+}
+export interface ContentPostsDeleteOutput {
+    /**
+     * The post id returned by content_posts_create.
+     */
+    postId: string;
+    /**
+     * The post and its content versions were deleted.
+     */
+    deleted: true;
+}
 export interface ContentPostsDetachMediaInput {
     /**
      * The post id.
@@ -78729,14 +78958,22 @@ export interface ContentPostsDetachMediaOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -78760,6 +78997,14 @@ export interface ContentPostsDetachMediaOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -78796,14 +79041,22 @@ export interface ContentPostsGetOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -78827,6 +79080,14 @@ export interface ContentPostsGetOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -78856,11 +79117,15 @@ export interface ContentPostsListInput {
     /**
      * Return only posts in this status.
      */
-    status?: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status?: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    /**
+     * Filter to one folder, or null for posts in no folder. Omit for posts in every folder.
+     */
+    folderId?: (string | null);
 }
 export interface ContentPostsListOutput {
     /**
-     * The page of posts, newest first.
+     * The page of posts, ordered by position when filtered to a folder and newest first otherwise.
      */
     posts: {
         /**
@@ -78875,14 +79140,22 @@ export interface ContentPostsListOutput {
          * Media references attached to the current version.
          */
         media: string[];
+        /**
+         * Private plan notes, or null when unset.
+         */
+        notes: (string | null);
+        /**
+         * Plan title, or null when unset.
+         */
+        title: (string | null);
         /**
          * Identity id of whoever composed the post.
          */
         author: string;
         /**
-         * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+         * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
          */
-        status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+        status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
         /**
          * The networks this post is meant for, each with its variant.
          */
@@ -78906,6 +79179,14 @@ export interface ContentPostsListOutput {
              */
             postType: string;
         }[];
+        /**
+         * Folder containing this post, or null.
+         */
+        folderId: (string | null);
+        /**
+         * Order within its folder, or null for an unfiled post.
+         */
+        position: (number | null);
         /**
          * ISO-8601 creation time.
          */
@@ -78928,6 +79209,97 @@ export interface ContentPostsListOutput {
      */
     total: number;
 }
+export interface ContentPostsMoveInput {
+    /**
+     * The post id returned by content_posts_create.
+     */
+    postId: string;
+    /**
+     * Destination folder in this product, or null to leave the post unfiled.
+     */
+    folderId: (string | null);
+    /**
+     * Put the post immediately before this post in the destination folder. Omit to append it.
+     */
+    beforePostId?: string;
+}
+export interface ContentPostsMoveOutput {
+    /**
+     * Post id.
+     */
+    id: string;
+    /**
+     * The current text of the post, in markdown.
+     */
+    text: string;
+    /**
+     * Media references attached to the current version.
+     */
+    media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
+    /**
+     * Identity id of whoever composed the post.
+     */
+    author: string;
+    /**
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     */
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    /**
+     * The networks this post is meant for, each with its variant.
+     */
+    targets: {
+        /**
+         * Markdown override for this network, or null to publish the post text.
+         */
+        text: (string | null);
+        /**
+         * Variant field values keyed by field id.
+         */
+        fields: {
+            [k: string]: string;
+        };
+        /**
+         * The network this variant is for.
+         */
+        network: string;
+        /**
+         * The post type id, from that network's capabilities.postTypes.
+         */
+        postType: string;
+    }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
+    /**
+     * ISO-8601 creation time.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 time of the last change.
+     */
+    updatedAt: string;
+    /**
+     * Version number of the current text.
+     */
+    currentVersion: number;
+    /**
+     * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
+     */
+    approvedVersion: (number | null);
+}
 export interface ContentPostsSubmitInput {
     /**
      * The post id returned by content_posts_create.
@@ -78947,14 +79319,188 @@ export interface ContentPostsSubmitOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
+    /**
+     * Identity id of whoever composed the post.
+     */
+    author: string;
+    /**
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     */
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    /**
+     * The networks this post is meant for, each with its variant.
+     */
+    targets: {
+        /**
+         * Markdown override for this network, or null to publish the post text.
+         */
+        text: (string | null);
+        /**
+         * Variant field values keyed by field id.
+         */
+        fields: {
+            [k: string]: string;
+        };
+        /**
+         * The network this variant is for.
+         */
+        network: string;
+        /**
+         * The post type id, from that network's capabilities.postTypes.
+         */
+        postType: string;
+    }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
+    /**
+     * ISO-8601 creation time.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 time of the last change.
+     */
+    updatedAt: string;
+    /**
+     * Version number of the current text.
+     */
+    currentVersion: number;
+    /**
+     * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
+     */
+    approvedVersion: (number | null);
+}
+export interface ContentPostsToDraftInput {
+    /**
+     * The post id returned by content_posts_create.
+     */
+    postId: string;
+}
+export interface ContentPostsToDraftOutput {
+    /**
+     * Post id.
+     */
+    id: string;
+    /**
+     * The current text of the post, in markdown.
+     */
+    text: string;
+    /**
+     * Media references attached to the current version.
+     */
+    media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
+    /**
+     * Identity id of whoever composed the post.
+     */
+    author: string;
+    /**
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     */
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    /**
+     * The networks this post is meant for, each with its variant.
+     */
+    targets: {
+        /**
+         * Markdown override for this network, or null to publish the post text.
+         */
+        text: (string | null);
+        /**
+         * Variant field values keyed by field id.
+         */
+        fields: {
+            [k: string]: string;
+        };
+        /**
+         * The network this variant is for.
+         */
+        network: string;
+        /**
+         * The post type id, from that network's capabilities.postTypes.
+         */
+        postType: string;
+    }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
+    /**
+     * ISO-8601 creation time.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 time of the last change.
+     */
+    updatedAt: string;
+    /**
+     * Version number of the current text.
+     */
+    currentVersion: number;
+    /**
+     * The version an approval binds to, or null. Cleared on every edit: approving one text never covers another.
+     */
+    approvedVersion: (number | null);
+}
+export interface ContentPostsToIdeaInput {
+    /**
+     * The post id returned by content_posts_create.
+     */
+    postId: string;
+}
+export interface ContentPostsToIdeaOutput {
+    /**
+     * Post id.
+     */
+    id: string;
+    /**
+     * The current text of the post, in markdown.
+     */
+    text: string;
+    /**
+     * Media references attached to the current version.
+     */
+    media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -78978,6 +79524,14 @@ export interface ContentPostsSubmitOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */
@@ -79001,7 +79555,7 @@ export interface ContentPostsUpdateInput {
      */
     id: string;
     /**
-     * Replacement text, in markdown. Omit to keep the current text.
+     * Replacement text, in markdown; it may be empty for an idea or draft. Omit to keep the current text.
      */
     text?: string;
     /**
@@ -79010,6 +79564,14 @@ export interface ContentPostsUpdateInput {
      * @maxItems 20
      */
     media?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string];
+    /**
+     * New private plan notes, or null to clear them. Changing them does not create a content version or revoke approval.
+     */
+    notes?: (string | null);
+    /**
+     * New plan title, or null to clear it. Changing it does not create a content version or revoke approval.
+     */
+    title?: (string | null);
     /**
      * Replacement target list (replaces, never merges). Omit to keep the current targets. Changing it is an edit like changing the text: a new version, and an approved post returns to pending_approval.
      *
@@ -83250,14 +83812,22 @@ export interface ContentPostsUpdateOutput {
      * Media references attached to the current version.
      */
     media: string[];
+    /**
+     * Private plan notes, or null when unset.
+     */
+    notes: (string | null);
+    /**
+     * Plan title, or null when unset.
+     */
+    title: (string | null);
     /**
      * Identity id of whoever composed the post.
      */
     author: string;
     /**
-     * Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
+     * Post lifecycle status: idea (may have no text) -> draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
      */
-    status: ("draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
+    status: ("idea" | "draft" | "pending_approval" | "approved" | "scheduled" | "published" | "failed");
     /**
      * The networks this post is meant for, each with its variant.
      */
@@ -83281,6 +83851,14 @@ export interface ContentPostsUpdateOutput {
          */
         postType: string;
     }[];
+    /**
+     * Folder containing this post, or null.
+     */
+    folderId: (string | null);
+    /**
+     * Order within its folder, or null for an unfiled post.
+     */
+    position: (number | null);
     /**
      * ISO-8601 creation time.
      */