@wix/auto_sdk_blog_draft-posts 1.0.3 → 1.0.5

package/build/es/src/blog-v3-draft-draft-posts.universal.d.ts

@@ -32,7 +32,7 @@ export interface DraftPost {
      */
     memberId?: string | null;
     /**
-     * Hashtags in the draft post.
+     * Hashtags in the post.
      * @maxSize 100
      * @maxLength 100
      */
@@ -59,7 +59,7 @@ export interface DraftPost {
      */
     relatedPostIds?: string[];
     /**
-     * Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan.
+     * Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan. See the Pricing Plans API for more info.
      * @maxSize 100
      * @format GUID
      */
@@ -80,22 +80,12 @@ export interface DraftPost {
      */
     language?: string | null;
     /**
-     * Reserved for internal use.
-     * @readonly
-     */
-    changeOrigin?: Origin;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxLength 24
-     */
-    contentId?: string | null;
-    /**
-     * Reserved for internal use.
-     * @format GUID
+     * Draft Post rich content.
+     *
+     * <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="image.gallery.video.audio.divider.linkButton.html.giphy.codeBlock.file.hashtag.lineSpacing.indent.link.textColor.textHighlight.heading.verticalEmbed.table.collapsibleList.poll" exampleid="72c23a25-524f-4f70-a260-4a2777b6f5d5">
+     * <a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a>
+     * </widget>
      */
-    editingSessionId?: string | null;
-    /** Draft post rich content. */
     richContent?: RichContent;
     /**
      * Status of the draft post.
@@ -104,12 +94,6 @@ export interface DraftPost {
     status?: Status;
     /** Details of the draft post in review. Only relevant to posts submitted by guest writers. */
     moderationDetails?: ModerationDetails;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @format GUID
-     */
-    mostRecentContributorId?: string | null;
     /**
      * Indicates if there are changes made to the draft post that have not yet been published.
      * @readonly
@@ -125,19 +109,10 @@ export interface DraftPost {
      * @readonly
      */
     scheduledPublishDate?: Date | null;
-    /** Reserved for internal use. */
-    content?: Record<string, any> | null;
     /** Date the post was first published. */
     firstPublishedDate?: Date | null;
     /** SEO data. */
     seoData?: SeoSchema;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxSize 5000
-     * @maxLength 100
-     */
-    slugs?: string[];
     /**
      * Draft post URL preview. What the URL will look like once the post is published.
      * @readonly
@@ -157,12 +132,6 @@ export interface DraftPost {
     media?: Media;
     /** Number of paragraphs to display in a paid content preview for non-paying users. */
     previewTextParagraph?: number | null;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxLength 24
-     */
-    internalId?: string | null;
 }
 export interface CoverMedia extends CoverMediaMediaOneOf {
     /** Image url. */
@@ -183,7 +152,12 @@ export interface CoverMedia extends CoverMediaMediaOneOf {
     /** Whether cover media is custom. If `false` the cover image is set to the first media item that appears in the content. */
     custom?: boolean;
     /**
-     * Media alternative text.
+     * Alternative text is a short phrase that describes what the image depicts.
+     *
+     * The alternative text is used:
+     * + If the browser cannot display the image.
+     * + If the user is utilizing a screen reader.
+     * + By search engines to understand what images are on a site.
      * @minLength 1
      * @maxLength 1000
      */
@@ -563,7 +537,7 @@ export interface Link extends LinkDataOneOf {
     /** The target node's ID. Used for linking to another node in this object. */
     anchor?: string;
     /**
-     * The HTML `target` attribute value for the link. This property defines where the linked document opens as follows:
+     * he HTML `target` attribute value for the link. This property defines where the linked document opens as follows:
      * `SELF` - Default. Opens the linked document in the same frame as the link.
      * `BLANK` - Opens the linked document in a new browser tab or window.
      * `PARENT` - Opens the linked document in the link's parent frame.
@@ -599,7 +573,7 @@ export interface Rel {
     sponsored?: boolean | null;
     /** Indicates that this link is user-generated content and isn't necessarily trusted or endorsed by the page’s author. For example, a link in a fourm post. Defaults to `false`. */
     ugc?: boolean | null;
-    /** Indicates that this link protects referral information from being passed to the target website. */
+    /** Indicates that this link protect referral information from being passed to the target website. */
     noreferrer?: boolean | null;
 }
 export interface CodeBlockData {
@@ -1650,12 +1624,6 @@ export declare enum Status {
     SCHEDULED = "SCHEDULED",
     /** Status indicating the draft post is deleted. */
     DELETED = "DELETED",
-    /**
-     * Deprecated. Use `IN_REVIEW` instead. Status indicating the draft post is in review.
-     * Target removal date 2024-06-30
-     * Reserved for internal use.
-     */
-    IN_MODERATION = "IN_MODERATION",
     /** Status indicating the draft post is in review. */
     IN_REVIEW = "IN_REVIEW"
 }
@@ -2082,11 +2050,6 @@ export declare enum Field {
     UNKNOWN = "UNKNOWN",
     /** Includes draft post preview URL. */
     URL = "URL",
-    /**
-     * Includes internal id field.
-     * Reserved for internal use.
-     */
-    INTERNAL_ID = "INTERNAL_ID",
     /** Includes content field. */
     CONTENT = "CONTENT",
     /** Includes rich content field. */
@@ -2165,14 +2128,6 @@ export interface BulkUpdateDraftPostsRequest {
     /**
      * Action to perform on the posts.
      *
-     * - `UPDATE`: Update the draft post.
-     * - `UPDATE_PUBLISH`: Update and publish the draft post.
-     * - `UPDATE_SCHEDULE`: Update the draft post and schedule a publish date.
-     * - `UPDATE_REVERT_TO_DRAFT`: Update the post and revert it to a draft post.
-     * - `UPDATE_CANCEL_SCHEDULE`: Update the draft post and cancel the scheduled publish date.
-     * - `UPDATE_REJECT`: Update and reject the draft post.
-     * - `UPDATE_PUBLICATION`: Update a published post. This creates and updates a draft version of the post. The original post is still published.
-     *
      * Default: `UPDATE`
      */
     action?: Action;
@@ -2189,7 +2144,7 @@ export interface BulkUpdateDraftPostsRequest {
     fieldsets?: Field[];
 }
 export interface MaskedDraftPosts {
-    /** Draft post info. */
+    /** Draft post */
     draftPost?: DraftPost;
     /** Field mask of fields to update. */
     fieldMask?: string[];
@@ -2321,7 +2276,7 @@ export interface UpdateDraftPostContentRequest extends UpdateDraftPostContentReq
      * @maxLength 400000
      */
     content?: string;
-    /** Draft post rich content. */
+    /** Draft Post rich content. */
     richContent?: RichContent;
     /**
      * Draft post ID.
@@ -2345,7 +2300,7 @@ export interface UpdateDraftPostContentRequestDraftContentOneOf {
      * @maxLength 400000
      */
     content?: string;
-    /** Draft post rich content. */
+    /** Draft Post rich content. */
     richContent?: RichContent;
 }
 export interface UpdateDraftPostContentResponse {
@@ -2421,7 +2376,6 @@ export interface ListDraftPostsRequest {
      * Draft post status filter.
      *
      * If omitted, draft posts with all statuses are returned.
-     * `IN_MODERATION` is deprecated, use `IN_REVIEW` instead.
      */
     status?: Status;
     /**
@@ -2556,19 +2510,6 @@ export interface CursorPaging {
 export interface QueryDraftPostsResponse {
     /** List of posts. */
     draftPosts?: DraftPost[];
-    /**
-     * __Deprecated.__ Use `pagingMetadata` instead.
-     * This property will be removed on June 30, 2023.
-     *
-     * Details on the paged set of results returned.
-     * @deprecated __Deprecated.__ Use `pagingMetadata` instead.
-     * This property will be removed on June 30, 2023.
-     *
-     * Details on the paged set of results returned.
-     * @replacedBy pagingMetadata
-     * @targetRemovalDate 2024-06-30
-     */
-    metaData?: MetaData;
     /** Details on the paged set of results returned. */
     pagingMetadata?: PagingMetadataV2;
 }
@@ -2695,12 +2636,6 @@ export interface Category {
      * @maxLength 100
      */
     slug?: string;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxLength 24
-     */
-    internalId?: string | null;
     /** SEO data. */
     seoData?: SeoSchema;
     /** Category cover image. */
@@ -3492,7 +3427,13 @@ export declare function onDraftUpdated(handler: (event: DraftUpdatedEnvelope) =>
 /**
  * Creates a draft post.
  *
- * The draft post's `memberId` is required for third-party apps.
+ * For 3rd-party apps, `memberId` is a required field.
+ *
+ * In `categoryIds`, only categories that already exist will be added to the draft post. Including
+ * `categoryIds` that do not exist will not return an error, but they will not be added to the `categoryIds` array.
+ * If some of the categories exist, those will be added while those that do not exist will not be added to `categoryIds`.
+ * You can check which categories are available with
+ * List Categories ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/categories/list-categories) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/category/list-categories)).
  * @param draftPost - Draft post to create.
  * @public
  * @requiredField draftPost
@@ -3570,14 +3511,6 @@ export interface BulkUpdateDraftPostsOptions {
     /**
      * Action to perform on the posts.
      *
-     * - `UPDATE`: Update the draft post.
-     * - `UPDATE_PUBLISH`: Update and publish the draft post.
-     * - `UPDATE_SCHEDULE`: Update the draft post and schedule a publish date.
-     * - `UPDATE_REVERT_TO_DRAFT`: Update the post and revert it to a draft post.
-     * - `UPDATE_CANCEL_SCHEDULE`: Update the draft post and cancel the scheduled publish date.
-     * - `UPDATE_REJECT`: Update and reject the draft post.
-     * - `UPDATE_PUBLICATION`: Update a published post. This creates and updates a draft version of the post. The original post is still published.
-     *
      * Default: `UPDATE`
      */
     action?: Action;
@@ -3596,7 +3529,7 @@ export interface BulkUpdateDraftPostsOptions {
 /**
  * Retrieves a list of up to 100 deleted draft posts.
  *
- * List Deleted Draft Posts runs with these defaults, which you can override:
+ * List Draft Posts runs with these defaults, which you can override:
  * - `editedDate` is sorted in descending order. In this case,`editedDate` implies the date the post was deleted.
  * - `paging.limit` is `50`.
  * - `paging.offset` is `0`.
@@ -3641,9 +3574,7 @@ export interface ListDeletedDraftPostsOptions {
     draftPostIds?: string[];
 }
 /**
- * Gets a draft post by the provided ID.
- *
- * Uses the provided `draftPostId` to retrieve a draft post.
+ * Retrieves a draft post by the provided ID.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3713,7 +3644,7 @@ export interface UpdateDraftPost {
      */
     memberId?: string | null;
     /**
-     * Hashtags in the draft post.
+     * Hashtags in the post.
      * @maxSize 100
      * @maxLength 100
      */
@@ -3740,7 +3671,7 @@ export interface UpdateDraftPost {
      */
     relatedPostIds?: string[];
     /**
-     * Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan.
+     * Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan. See the Pricing Plans API for more info.
      * @maxSize 100
      * @format GUID
      */
@@ -3761,22 +3692,12 @@ export interface UpdateDraftPost {
      */
     language?: string | null;
     /**
-     * Reserved for internal use.
-     * @readonly
-     */
-    changeOrigin?: Origin;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxLength 24
-     */
-    contentId?: string | null;
-    /**
-     * Reserved for internal use.
-     * @format GUID
+     * Draft Post rich content.
+     *
+     * <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="image.gallery.video.audio.divider.linkButton.html.giphy.codeBlock.file.hashtag.lineSpacing.indent.link.textColor.textHighlight.heading.verticalEmbed.table.collapsibleList.poll" exampleid="72c23a25-524f-4f70-a260-4a2777b6f5d5">
+     * <a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a>
+     * </widget>
      */
-    editingSessionId?: string | null;
-    /** Draft post rich content. */
     richContent?: RichContent;
     /**
      * Status of the draft post.
@@ -3785,12 +3706,6 @@ export interface UpdateDraftPost {
     status?: Status;
     /** Details of the draft post in review. Only relevant to posts submitted by guest writers. */
     moderationDetails?: ModerationDetails;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @format GUID
-     */
-    mostRecentContributorId?: string | null;
     /**
      * Indicates if there are changes made to the draft post that have not yet been published.
      * @readonly
@@ -3806,19 +3721,10 @@ export interface UpdateDraftPost {
      * @readonly
      */
     scheduledPublishDate?: Date | null;
-    /** Reserved for internal use. */
-    content?: Record<string, any> | null;
     /** Date the post was first published. */
     firstPublishedDate?: Date | null;
     /** SEO data. */
     seoData?: SeoSchema;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxSize 5000
-     * @maxLength 100
-     */
-    slugs?: string[];
     /**
      * Draft post URL preview. What the URL will look like once the post is published.
      * @readonly
@@ -3838,12 +3744,6 @@ export interface UpdateDraftPost {
     media?: Media;
     /** Number of paragraphs to display in a paid content preview for non-paying users. */
     previewTextParagraph?: number | null;
-    /**
-     * Reserved for internal use.
-     * @readonly
-     * @maxLength 24
-     */
-    internalId?: string | null;
 }
 export interface UpdateDraftPostOptions {
     /**
@@ -3863,10 +3763,10 @@ export interface UpdateDraftPostOptions {
     fieldsets?: Field[];
 }
 /**
- * Moves a draft post with the provided ID to the trash bin.
- * A published post can also be deleted by its provided `draftPostId`.
+ * Moves a draft post to the trash bin.
+ * A published post can also be deleted by the `post.id`. See the Posts API ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/posts/) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/post-object)) for more information about posts.
  *
- * The optional `permanent` field enables you to delete a post permanently, bypassing the trash bin. When a draft post is deleted this way, it can't be restored.
+ * To permanently delete a post bypassing the trash bin, set the `permanent` field value to `true`. The post can't be restored after this.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3887,9 +3787,9 @@ export interface DeleteDraftPostOptions {
     permanent?: boolean;
 }
 /**
- * Permanently deletes a draft post by the provided ID from the trash bin.
+ * Permanently deletes a draft post that is currently in the trash bin.
  *
- * Uses the provided `draftPostId` to permanently delete a draft post from the trash bin. This action is permanent and cannot be reversed.
+ * This action is permanent and can't be reversed.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3938,7 +3838,6 @@ export interface ListDraftPostsOptions {
      * Draft post status filter.
      *
      * If omitted, draft posts with all statuses are returned.
-     * `IN_MODERATION` is deprecated, use `IN_REVIEW` instead.
      */
     status?: Status;
     /**
@@ -3966,9 +3865,7 @@ export interface ListDraftPostsOptions {
     fieldsets?: Field[];
 }
 /**
- * Gets a deleted draft post from the trash bin by the provided ID.
- *
- * Uses the provided `draftPostId` to retrieve a previously deleted draft post from the trash bin.
+ * Retrieves a deleted draft post from the trash bin by the provided ID.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3981,8 +3878,6 @@ export interface ListDraftPostsOptions {
 export declare function getDeletedDraftPost(draftPostId: string): Promise<GetDeletedDraftPostResponse & GetDeletedDraftPostResponseNonNullableFields>;
 /**
  * Restores a deleted draft post from the trash bin by the provided ID.
- *
- * Uses the `draftPostId` to restore a deleted draft post from the trash bin.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3994,12 +3889,20 @@ export declare function getDeletedDraftPost(draftPostId: string): Promise<GetDel
  */
 export declare function restoreFromTrashBin(draftPostId: string): Promise<RestoreFromTrashBinResponse & RestoreFromTrashBinResponseNonNullableFields>;
 /**
- * Retrieves a list of up to 100 draft posts, given the provided paging, filtering, and sorting.
+ * Creates a query to retrieve a list of up to 100 draft posts.
  *
- * Query Draft Posts runs with these defaults, which you can override:
- * - `editedDate` is sorted in `DESC` order.
- * - `paging.limit` is `50`.
- * - `paging.offset` is `0`.
+ *
+ * The `queryDraftPosts()` function builds a query to retrieve a list of up to 100 draft posts, and returns a `DraftPostsQueryBuilder` object.
+ *
+ * The returned object contains the query definition, which is typically used to run the query using the `find()` function.
+ *
+ * You can refine the query by chaining `DraftPostsQueryBuilder` functions onto the query. `DraftPostsQueryBuilder` functions enable you to sort, filter, and control the results that `queryDraftPosts()` returns.
+ *
+ * `queryDraftPosts()` runs with these `DraftPostsQueryBuilder` defaults that can be overridden:
+ * - `limit(50)`
+ * - `ascending('_id')`
+ *
+ * The following `DraftPostsQueryBuilder` functions are supported for `queryDraftPosts()`. For a full description of the Draft Posts object, see the object returned for the `items` property in `DraftPostsQueryResult`.
  * @public
  * @param options - Options for querying draft posts.
  * @permissionScope Manage Blog
@@ -4073,9 +3976,11 @@ export interface DraftPostsQueryBuilder {
     find: () => Promise<DraftPostsQueryResult>;
 }
 /**
- * Publishes a specified draft post by ID. This creates a new post entity with the data from the draft post.
+ * Publishes a draft post by ID. This creates a new post ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/posts/) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/post-object))
+ * with the data from the draft post.
  *
- * If the specified draft post was already published, the published post will be updated with the latest values from the draft post entity.
+ * If the draft post was already published, the published post will be updated with the latest values
+ * from the draft post.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId

package/build/es/src/blog-v3-draft-draft-posts.universal.js

@@ -404,12 +404,6 @@ export var Status;
     Status["SCHEDULED"] = "SCHEDULED";
     /** Status indicating the draft post is deleted. */
     Status["DELETED"] = "DELETED";
-    /**
-     * Deprecated. Use `IN_REVIEW` instead. Status indicating the draft post is in review.
-     * Target removal date 2024-06-30
-     * Reserved for internal use.
-     */
-    Status["IN_MODERATION"] = "IN_MODERATION";
     /** Status indicating the draft post is in review. */
     Status["IN_REVIEW"] = "IN_REVIEW";
 })(Status || (Status = {}));
@@ -454,11 +448,6 @@ export var Field;
     Field["UNKNOWN"] = "UNKNOWN";
     /** Includes draft post preview URL. */
     Field["URL"] = "URL";
-    /**
-     * Includes internal id field.
-     * Reserved for internal use.
-     */
-    Field["INTERNAL_ID"] = "INTERNAL_ID";
     /** Includes content field. */
     Field["CONTENT"] = "CONTENT";
     /** Includes rich content field. */
@@ -498,7 +487,13 @@ export var SortOrder;
 /**
  * Creates a draft post.
  *
- * The draft post's `memberId` is required for third-party apps.
+ * For 3rd-party apps, `memberId` is a required field.
+ *
+ * In `categoryIds`, only categories that already exist will be added to the draft post. Including
+ * `categoryIds` that do not exist will not return an error, but they will not be added to the `categoryIds` array.
+ * If some of the categories exist, those will be added while those that do not exist will not be added to `categoryIds`.
+ * You can check which categories are available with
+ * List Categories ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/categories/list-categories) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/category/list-categories)).
  * @param draftPost - Draft post to create.
  * @public
  * @requiredField draftPost
@@ -775,7 +770,7 @@ export async function bulkUpdateDraftPosts(options) {
 /**
  * Retrieves a list of up to 100 deleted draft posts.
  *
- * List Deleted Draft Posts runs with these defaults, which you can override:
+ * List Draft Posts runs with these defaults, which you can override:
  * - `editedDate` is sorted in descending order. In this case,`editedDate` implies the date the post was deleted.
  * - `paging.limit` is `50`.
  * - `paging.offset` is `0`.
@@ -845,9 +840,7 @@ export async function listDeletedDraftPosts(options) {
     }
 }
 /**
- * Gets a draft post by the provided ID.
- *
- * Uses the provided `draftPostId` to retrieve a draft post.
+ * Retrieves a draft post by the provided ID.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -1003,10 +996,10 @@ export async function updateDraftPost(_id, draftPost, options) {
     }
 }
 /**
- * Moves a draft post with the provided ID to the trash bin.
- * A published post can also be deleted by its provided `draftPostId`.
+ * Moves a draft post to the trash bin.
+ * A published post can also be deleted by the `post.id`. See the Posts API ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/posts/) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/post-object)) for more information about posts.
  *
- * The optional `permanent` field enables you to delete a post permanently, bypassing the trash bin. When a draft post is deleted this way, it can't be restored.
+ * To permanently delete a post bypassing the trash bin, set the `permanent` field value to `true`. The post can't be restored after this.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -1044,9 +1037,9 @@ export async function deleteDraftPost(draftPostId, options) {
     }
 }
 /**
- * Permanently deletes a draft post by the provided ID from the trash bin.
+ * Permanently deletes a draft post that is currently in the trash bin.
  *
- * Uses the provided `draftPostId` to permanently delete a draft post from the trash bin. This action is permanent and cannot be reversed.
+ * This action is permanent and can't be reversed.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -1214,9 +1207,7 @@ export async function listDraftPosts(options) {
     }
 }
 /**
- * Gets a deleted draft post from the trash bin by the provided ID.
- *
- * Uses the provided `draftPostId` to retrieve a previously deleted draft post from the trash bin.
+ * Retrieves a deleted draft post from the trash bin by the provided ID.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -1275,8 +1266,6 @@ export async function getDeletedDraftPost(draftPostId) {
 }
 /**
  * Restores a deleted draft post from the trash bin by the provided ID.
- *
- * Uses the `draftPostId` to restore a deleted draft post from the trash bin.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -1334,12 +1323,20 @@ export async function restoreFromTrashBin(draftPostId) {
     }
 }
 /**
- * Retrieves a list of up to 100 draft posts, given the provided paging, filtering, and sorting.
+ * Creates a query to retrieve a list of up to 100 draft posts.
  *
- * Query Draft Posts runs with these defaults, which you can override:
- * - `editedDate` is sorted in `DESC` order.
- * - `paging.limit` is `50`.
- * - `paging.offset` is `0`.
+ *
+ * The `queryDraftPosts()` function builds a query to retrieve a list of up to 100 draft posts, and returns a `DraftPostsQueryBuilder` object.
+ *
+ * The returned object contains the query definition, which is typically used to run the query using the `find()` function.
+ *
+ * You can refine the query by chaining `DraftPostsQueryBuilder` functions onto the query. `DraftPostsQueryBuilder` functions enable you to sort, filter, and control the results that `queryDraftPosts()` returns.
+ *
+ * `queryDraftPosts()` runs with these `DraftPostsQueryBuilder` defaults that can be overridden:
+ * - `limit(50)`
+ * - `ascending('_id')`
+ *
+ * The following `DraftPostsQueryBuilder` functions are supported for `queryDraftPosts()`. For a full description of the Draft Posts object, see the object returned for the `items` property in `DraftPostsQueryResult`.
  * @public
  * @param options - Options for querying draft posts.
  * @permissionScope Manage Blog
@@ -1419,9 +1416,11 @@ export function queryDraftPosts(options) {
     });
 }
 /**
- * Publishes a specified draft post by ID. This creates a new post entity with the data from the draft post.
+ * Publishes a draft post by ID. This creates a new post ([SDK](https://dev.wix.com/docs/sdk/backend-modules/blog/posts/) | [REST](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats/post-object))
+ * with the data from the draft post.
  *
- * If the specified draft post was already published, the published post will be updated with the latest values from the draft post entity.
+ * If the draft post was already published, the published post will be updated with the latest values
+ * from the draft post.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId