@wix/auto_sdk_blog_draft-posts 1.0.2 → 1.0.4

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

@@ -2,24 +2,40 @@ export interface DraftPost {
     /**
      * Draft post ID.
      * @readonly
+     * @maxLength 38
      */
     _id?: string;
-    /** Draft post title. */
+    /**
+     * Draft post title.
+     * @maxLength 200
+     */
     title?: string;
     /**
      * Draft post excerpt.
      *
      * If no excerpt has been manually set, an excerpt is automatically generated from the post's text.
      * This can be retrieved using the `GENERATED_EXCERPT` fieldset.
+     * @maxLength 500
      */
     excerpt?: string | null;
     /** Whether the draft post is marked as featured. */
     featured?: boolean | null;
-    /** Category IDs of the draft post. */
+    /**
+     * Category IDs of the draft post.
+     * @maxSize 10
+     * @maxLength 38
+     */
     categoryIds?: string[];
-    /** Draft post owner's member ID. */
+    /**
+     * Draft post owner's member ID.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Hashtags in the draft post. */
+    /**
+     * Hashtags in the post.
+     * @maxSize 100
+     * @maxLength 100
+     */
     hashtags?: string[];
     /** Whether commenting on the draft post is enabled. */
     commentingEnabled?: boolean | null;
@@ -30,23 +46,37 @@ export interface DraftPost {
     minutesToRead?: number;
     /** Image placed at the top of the blog page. */
     heroImage?: string;
-    /** Tag IDs the draft post is tagged with. */
+    /**
+     * Tag IDs the draft post is tagged with.
+     * @maxSize 30
+     * @maxLength 38
+     */
     tagIds?: string[];
-    /** IDs of posts related to this draft post. */
+    /**
+     * IDs of posts related to this draft post.
+     * @maxSize 3
+     * @maxLength 38
+     */
     relatedPostIds?: string[];
-    /** Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan. */
+    /**
+     * [Pricing plan IDs](https://dev.wix.com/api/rest/wix-pricing-plans). Only relevant if a post is assigned to a specific pricing plan.
+     * @maxSize 100
+     * @format GUID
+     */
     pricingPlanIds?: string[];
     /**
      * ID of the draft post's translations.
      *
      * All translations of a single post share the same `translationId`.
      * Available only if the [Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) app is installed.
+     * @format GUID
      */
     translationId?: string | null;
     /**
      * Language the draft post is written in.
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -57,11 +87,21 @@ export interface DraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxLength 24
      */
     contentId?: string | null;
-    /** Reserved for internal use. */
+    /**
+     * Reserved for internal use.
+     * @format GUID
+     */
     editingSessionId?: string | null;
-    /** Draft post rich content. */
+    /**
+     * 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>
+     */
     richContent?: RichContent;
     /**
      * Status of the draft post.
@@ -73,6 +113,7 @@ export interface DraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @format GUID
      */
     mostRecentContributorId?: string | null;
     /**
@@ -97,8 +138,7 @@ export interface DraftPost {
     /** SEO data. */
     seoData?: SeoSchema;
     /**
-     * @internal Deprecated.
-     * @internal Deprecated.
+     * Reserved for internal use.
      * @deprecated
      * @replacedBy preview_text_paragraph
      * @targetRemovalDate 2024-06-30
@@ -107,6 +147,8 @@ export interface DraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxSize 5000
+     * @maxLength 100
      */
     slugs?: string[];
     /**
@@ -119,7 +161,10 @@ export interface DraftPost {
      * @readonly
      */
     _createdDate?: Date | null;
-    /** SEO slug. */
+    /**
+     * SEO slug.
+     * @maxLength 100
+     */
     seoSlug?: string | null;
     /** Post cover media. */
     media?: Media;
@@ -128,6 +173,7 @@ export interface DraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxLength 24
      */
     internalId?: string | null;
 }
@@ -149,7 +195,11 @@ export interface CoverMedia extends CoverMediaMediaOneOf {
     displayed?: boolean;
     /** 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. */
+    /**
+     * Media alternative text.
+     * @minLength 1
+     * @maxLength 1000
+     */
     altText?: string | null;
 }
 /** @oneof */
@@ -526,7 +576,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.
@@ -562,7 +612,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 {
@@ -840,11 +890,20 @@ export interface GIFData {
     gifType?: GIFType;
 }
 export interface GIF {
-    /** GIF format URL. */
+    /**
+     * GIF format URL.
+     * @format WEB_URL
+     */
     gif?: string | null;
-    /** MP4 format URL. */
+    /**
+     * MP4 format URL.
+     * @format WEB_URL
+     */
     mp4?: string | null;
-    /** Thumbnail URL. */
+    /**
+     * Thumbnail URL.
+     * @format WEB_URL
+     */
     still?: string | null;
 }
 export declare enum GIFType {
@@ -910,6 +969,25 @@ export interface ImageData {
     caption?: string | null;
     /** Sets whether the image's download button is disabled. Defaults to `false`. */
     disableDownload?: boolean | null;
+    /** Sets whether the image is decorative and does not need an explanation. Defaults to `false`. */
+    decorative?: boolean | null;
+    /** Styling for the image. */
+    styles?: ImageDataStyles;
+}
+export interface StylesBorder {
+    /** Border width in pixels. */
+    width?: number | null;
+    /**
+     * Border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Border radius in pixels. */
+    radius?: number | null;
+}
+export interface ImageDataStyles {
+    /** Border attributes. */
+    border?: StylesBorder;
 }
 export interface LinkPreviewData {
     /** Styling for the link preview's container. */
@@ -924,6 +1002,51 @@ export interface LinkPreviewData {
     description?: string | null;
     /** The preview content as HTML. */
     html?: string | null;
+    /** Styling for the link preview. */
+    styles?: LinkPreviewDataStyles;
+}
+export declare enum Position {
+    /** Thumbnail positioned at the start (left in LTR layouts, right in RTL layouts) */
+    START = "START",
+    /** Thumbnail positioned at the end (right in LTR layouts, left in RTL layouts) */
+    END = "END",
+    /** Thumbnail positioned at the top */
+    TOP = "TOP",
+    /** Thumbnail hidden and not displayed */
+    HIDDEN = "HIDDEN"
+}
+export interface LinkPreviewDataStyles {
+    /**
+     * Background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    backgroundColor?: string | null;
+    /**
+     * Title color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    titleColor?: string | null;
+    /**
+     * Subtitle color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    subtitleColor?: string | null;
+    /**
+     * Link color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    linkColor?: string | null;
+    /** Border width in pixels. */
+    borderWidth?: number | null;
+    /** Border radius in pixels. */
+    borderRadius?: number | null;
+    /**
+     * Border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    borderColor?: string | null;
+    /** Position of thumbnail. Defaults to `START`. */
+    thumbnailPosition?: Position;
 }
 export interface MapData {
     /** Styling for the map's container. */
@@ -1056,13 +1179,22 @@ export declare enum BackgroundType {
 export interface Gradient {
     /** The gradient angle in degrees. */
     angle?: number | null;
-    /** The start color as a hexademical value. */
+    /**
+     * The start color as a hexademical value.
+     * @format COLOR_HEX
+     */
     startColor?: string | null;
-    /** The end color as a hexademical value. */
+    /**
+     * The end color as a hexademical value.
+     * @format COLOR_HEX
+     */
     lastColor?: string | null;
 }
 export interface Background extends BackgroundBackgroundOneOf {
-    /** The background color as a hexademical value. */
+    /**
+     * The background color as a hexademical value.
+     * @format COLOR_HEX
+     */
     color?: string | null;
     /** An image to use for the background. */
     image?: V1Media;
@@ -1073,7 +1205,10 @@ export interface Background extends BackgroundBackgroundOneOf {
 }
 /** @oneof */
 export interface BackgroundBackgroundOneOf {
-    /** The background color as a hexademical value. */
+    /**
+     * The background color as a hexademical value.
+     * @format COLOR_HEX
+     */
     color?: string | null;
     /** An image to use for the background. */
     image?: V1Media;
@@ -1385,17 +1520,32 @@ export declare enum VerticalAlignment {
 export interface CellStyle {
     /** Vertical alignment for the cell's text. */
     verticalAlignment?: VerticalAlignment;
-    /** Cell background color as a hexadecimal value. */
+    /**
+     * Cell background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     backgroundColor?: string | null;
 }
 export interface BorderColors {
-    /** Left border color as a hexadecimal value. */
+    /**
+     * Left border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     left?: string | null;
-    /** Right border color as a hexadecimal value. */
+    /**
+     * Right border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     right?: string | null;
-    /** Top border color as a hexadecimal value. */
+    /**
+     * Top border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     top?: string | null;
-    /** Bottom border color as a hexadecimal value. */
+    /**
+     * Bottom border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     bottom?: string | null;
 }
 /**
@@ -1523,13 +1673,19 @@ export declare enum Status {
     IN_REVIEW = "IN_REVIEW"
 }
 export interface ModerationDetails {
-    /** Member ID of the person submitting the draft post for review. */
+    /**
+     * Member ID of the person submitting the draft post for review.
+     * @format GUID
+     */
     submittedBy?: string;
     /** Date the post was submitted for review. */
     submittedDate?: Date | null;
     /** Status indicating whether the submission was approved or rejected by the moderator. */
     status?: ModerationStatusStatus;
-    /** Member ID of the person who approved or rejected the post. */
+    /**
+     * Member ID of the person who approved or rejected the post.
+     * @format GUID
+     */
     moderatedBy?: string | null;
     /** Date the post was approved or rejected. */
     moderationDate?: Date | null;
@@ -1555,7 +1711,10 @@ export interface Keyword {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** The source that added the keyword terms to the SEO settings. */
+    /**
+     * The source that added the keyword terms to the SEO settings.
+     * @maxLength 1000
+     */
     origin?: string | null;
 }
 export interface Tag {
@@ -1588,7 +1747,10 @@ export interface Settings {
      * Default: `false` (Auto Redirect is enabled.)
      */
     preventAutoRedirect?: boolean;
-    /** User-selected keyword terms for a specific page. */
+    /**
+     * User-selected keyword terms for a specific page.
+     * @maxSize 5
+     */
     keywords?: Keyword[];
 }
 export interface Media extends MediaMediaOneOf {
@@ -1600,7 +1762,11 @@ export interface Media extends MediaMediaOneOf {
     displayed?: boolean;
     /** Whether custom cover media has been specified. If `false`, the first media item in the post's content serves as cover media. */
     custom?: boolean;
-    /** Media alternative text. */
+    /**
+     * Media alternative text.
+     * @minLength 1
+     * @maxLength 1000
+     */
     altText?: string | null;
 }
 /** @oneof */
@@ -1633,7 +1799,10 @@ export interface EmbedMedia {
     video?: EmbedVideo;
 }
 export interface EmbedThumbnail {
-    /** Thumbnail url. */
+    /**
+     * Thumbnail url.
+     * @maxLength 2000
+     */
     url?: string;
     /** Thumbnail width. */
     width?: number;
@@ -1641,7 +1810,10 @@ export interface EmbedThumbnail {
     height?: number;
 }
 export interface EmbedVideo {
-    /** Video url. */
+    /**
+     * Video url.
+     * @maxLength 2000
+     */
     url?: string;
     /** Video width. */
     width?: number;
@@ -1649,171 +1821,380 @@ export interface EmbedVideo {
     height?: number;
 }
 export interface DraftPostTranslation {
-    /** Post ID. */
+    /**
+     * Post ID.
+     * @format GUID
+     */
     _id?: string;
     /** Post status. */
     status?: Status;
-    /** Language the post is written in. */
+    /**
+     * Language the post is written in.
+     * @format LANGUAGE_TAG
+     */
     language?: string | null;
-    /** Post slug. For example, 'post-slug'. */
+    /**
+     * Post slug. For example, 'post-slug'.
+     * @maxLength 100
+     */
     slug?: string | null;
     /** SEO data. */
     seoData?: SeoSchema;
     /** Post URL. */
     url?: string;
 }
-export interface InitialDraftPostsCopied {
-    /** Number of draft posts copied. */
-    count?: number;
-}
 export interface DraftCategoriesUpdated {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId?: string;
-    /** Current categories of the draft. */
+    /**
+     * Current categories of the draft.
+     * @maxSize 10
+     * @format GUID
+     */
     categories?: string[];
-    /** Previous categories of the draft. */
+    /**
+     * Previous categories of the draft.
+     * @maxSize 10
+     * @format GUID
+     */
     previousCategories?: string[];
 }
 export interface DraftTagsUpdated {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId?: string;
-    /** Current tags of the draft. */
+    /**
+     * Current tags of the draft.
+     * @maxSize 30
+     * @format GUID
+     */
     tags?: string[];
-    /** Previous tags of the draft. */
+    /**
+     * Previous tags of the draft.
+     * @maxSize 30
+     * @format GUID
+     */
     previousTags?: string[];
 }
-export interface CreateDraftPostRequest {
-    /** Draft post to create. */
-    draftPost: DraftPost;
+export interface GetDraftPostTotalsRequest {
     /**
-     * Whether the draft post should be published on creation.
-     *
-     * Default: `false`
+     * Group results by fields (defaults to grouping by status).
+     * If, for example, grouping by language is passed, language values in response will be filled.
+     * If, for example, grouping by language is not passed, null values will be filled in language field in response.
+     * @maxSize 10
      */
-    publish?: boolean;
+    groupBy?: TotalDraftPostsGroupingField[];
     /**
-     * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
-     * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
-     * only the draft post's base fields are returned.
+     * Optional language filter by provided language code. Useful in multilingual context.
+     * @format LANGUAGE_TAG
      */
-    fieldsets?: Field[];
+    language?: string | null;
 }
-export declare enum Type {
-    UNKNOWN = "UNKNOWN",
-    /** Manually saved. */
-    MANUAL = "MANUAL",
-    /** Triggered by autosave. */
-    AUTO_SAVE = "AUTO_SAVE",
-    /** Copied from template during provisioning flow. */
-    PROVISIONING = "PROVISIONING",
-    /** Imported from another blog. */
-    IMPORT = "IMPORT",
-    /** Triggered by autosave when post created by AI tool. */
-    AI_AUTO_SAVE = "AI_AUTO_SAVE"
+export declare enum TotalDraftPostsGroupingField {
+    /** Groups results by status. */
+    STATUS = "STATUS",
+    /** Groups results by language. */
+    LANGUAGE = "LANGUAGE"
 }
-export declare enum Field {
-    /** Unknown field. */
-    UNKNOWN = "UNKNOWN",
-    /** Includes draft post preview URL. */
-    URL = "URL",
+export interface GetDraftPostTotalsResponse {
+    /** Draft post totals. */
+    totalDraftPosts?: TotalDraftPosts[];
+}
+export interface TotalDraftPosts {
+    /** Draft post totals in that group. */
+    total?: number;
+    /** Draft post status (only has value when grouping by status, otherwise null). */
+    status?: Status;
     /**
-     * Includes internal id field.
-     * Reserved for internal use.
+     * Draft post language code (only has value when grouping by language, otherwise null).
+     * @format LANGUAGE_TAG
      */
-    INTERNAL_ID = "INTERNAL_ID",
-    /** Includes content field. */
-    CONTENT = "CONTENT",
-    /** Includes rich content field. */
-    RICH_CONTENT = "RICH_CONTENT",
-    /** If the user has not set excerpt, returns the one autogenerated from content. */
-    GENERATED_EXCERPT = "GENERATED_EXCERPT"
-}
-export interface CreateDraftPostResponse {
-    /** Created draft post info. */
-    draftPost?: DraftPost;
+    language?: string | null;
 }
-export interface BulkCreateDraftPostsRequest {
-    /** Draft posts to create. */
-    draftPosts: DraftPost[];
-    /** Whether the draft post should be published after creation. */
-    publish?: boolean;
-    /** Whether to return the full created draft post entities in the response. */
-    returnFullEntity?: boolean;
+export interface DomainEvent extends DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
     /**
-     * List of draft post fields to be included in the response if the entities are present.
-     * Base default fieldset returns all core draft post properties (all properties that are not a supported fieldset value).
-     * For example,  when `URL` fieldset is selected, returned draft post will include the set of base properties and the draft post's preview url.
+     * Unique event ID.
+     * Allows clients to ignore duplicate webhooks.
      */
-    fieldsets?: Field[];
-}
-export interface BulkCreateDraftPostsResponse {
-    /** Draft posts created by bulk action. */
-    results?: BulkDraftPostResult[];
-    /** Bulk action metadata. */
-    bulkActionMetadata?: BulkActionMetadata;
-}
-export interface BulkDraftPostResult {
-    /** Bulk actions metadata for draft post. */
-    itemMetadata?: ItemMetadata;
-    /** Optional full draft post. */
-    item?: DraftPost;
-}
-export interface ItemMetadata {
-    /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
-    _id?: string | null;
-    /** Index of the item within the request array. Allows for correlation between request and response items. */
-    originalIndex?: number;
-    /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
-    success?: boolean;
-    /** Details about the error in case of failure. */
-    error?: ApplicationError;
-}
-export interface ApplicationError {
-    /** Error code. */
-    code?: string;
-    /** Description of the error. */
-    description?: string;
-    /** Data related to the error. */
-    data?: Record<string, any> | null;
-}
-export interface BulkActionMetadata {
-    /** Number of items that were successfully processed. */
-    totalSuccesses?: number;
-    /** Number of items that couldn't be processed. */
-    totalFailures?: number;
-    /** Number of failures without details because detailed failure threshold was exceeded. */
-    undetailedFailures?: number;
-}
-export interface BulkUpdateDraftPostsRequest {
-    /** Draft posts to update. */
-    draftPosts?: MaskedDraftPosts[];
+    _id?: string;
     /**
-     * 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`
+     * Assumes actions are also always typed to an entity_type
+     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
      */
-    action?: Action;
-    /** Posts' scheduled publish date when `action` is set to `UPDATE_SCHEDULE`. */
-    scheduledPublishDate?: Date | null;
-    /** Whether to return the full updated draft post entities in the response. */
-    returnFullEntity?: boolean;
+    entityFqdn?: string;
     /**
-     * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
-     * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
-     * only the draft post's base fields are returned.
+     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
+     * This is although the created/updated/deleted notion is duplication of the oneof types
+     * Example: created/updated/deleted/started/completed/email_opened
      */
-    fieldsets?: Field[];
-}
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number defining the order of updates to the underlying entity.
+     * For example, given that some entity was updated at 16:00 and than again at 16:01,
+     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
+     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
+     * To do so, you will need to persist this number on your end, and compare the sequence number from the
+     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     */
+    entityEventSequence?: string | null;
+}
+/** @oneof */
+export interface DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+}
+export interface EntityCreatedEvent {
+    entity?: string;
+}
+export interface RestoreInfo {
+    deletedDate?: Date | null;
+}
+export interface EntityUpdatedEvent {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntity?: string;
+}
+export interface EntityDeletedEvent {
+    /** Entity that was deleted */
+    deletedEntity?: string | null;
+}
+export interface ActionEvent {
+    body?: string;
+}
+export interface MessageEnvelope {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Stringify payload. */
+    data?: string;
+}
+export interface IdentificationData extends IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+    /** @readonly */
+    identityType?: WebhookIdentityType;
+}
+/** @oneof */
+export interface IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+}
+export declare enum WebhookIdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+export interface InitialDraftPostsCopied {
+    /** Number of draft posts copied. */
+    count?: number;
+}
+export interface CreateDraftPostRequest {
+    /** Draft post to create. */
+    draftPost: DraftPost;
+    /**
+     * Whether the draft post should be published on creation.
+     *
+     * Default: `false`
+     */
+    publish?: boolean;
+    /**
+     * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
+     * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
+     * only the draft post's base fields are returned.
+     * @maxSize 10
+     */
+    fieldsets?: Field[];
+}
+export declare enum Type {
+    UNKNOWN = "UNKNOWN",
+    /** Manually saved. */
+    MANUAL = "MANUAL",
+    /** Triggered by autosave. */
+    AUTO_SAVE = "AUTO_SAVE",
+    /** Copied from template during provisioning flow. */
+    PROVISIONING = "PROVISIONING",
+    /** Imported from another blog. */
+    IMPORT = "IMPORT",
+    /** Triggered by autosave when post created by AI tool. */
+    AI_AUTO_SAVE = "AI_AUTO_SAVE"
+}
+export declare enum Field {
+    /** Unknown 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. */
+    RICH_CONTENT = "RICH_CONTENT",
+    /** If the user has not set excerpt, returns the one autogenerated from content. */
+    GENERATED_EXCERPT = "GENERATED_EXCERPT"
+}
+export interface CreateDraftPostResponse {
+    /** Created draft post info. */
+    draftPost?: DraftPost;
+}
+export interface BulkCreateDraftPostsRequest {
+    /**
+     * Draft posts to create.
+     * @minSize 1
+     * @maxSize 20
+     */
+    draftPosts: DraftPost[];
+    /** Whether the draft post should be published after creation. */
+    publish?: boolean;
+    /** Whether to return the full created draft post entities in the response. */
+    returnFullEntity?: boolean;
+    /**
+     * List of draft post fields to be included in the response if the entities are present.
+     * Base default fieldset returns all core draft post properties (all properties that are not a supported fieldset value).
+     * For example,  when `URL` fieldset is selected, returned draft post will include the set of base properties and the draft post's preview url.
+     * @maxSize 10
+     */
+    fieldsets?: Field[];
+}
+export interface BulkCreateDraftPostsResponse {
+    /** Draft posts created by bulk action. */
+    results?: BulkDraftPostResult[];
+    /** Bulk action metadata. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface BulkDraftPostResult {
+    /** Bulk actions metadata for draft post. */
+    itemMetadata?: ItemMetadata;
+    /** Optional full draft post. */
+    item?: DraftPost;
+}
+export interface ItemMetadata {
+    /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
+    _id?: string | null;
+    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    originalIndex?: number;
+    /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
+    success?: boolean;
+    /** Details about the error in case of failure. */
+    error?: ApplicationError;
+}
+export interface ApplicationError {
+    /** Error code. */
+    code?: string;
+    /** Description of the error. */
+    description?: string;
+    /** Data related to the error. */
+    data?: Record<string, any> | null;
+}
+export interface BulkActionMetadata {
+    /** Number of items that were successfully processed. */
+    totalSuccesses?: number;
+    /** Number of items that couldn't be processed. */
+    totalFailures?: number;
+    /** Number of failures without details because detailed failure threshold was exceeded. */
+    undetailedFailures?: number;
+}
+export interface BulkUpdateDraftPostsRequest {
+    /**
+     * Draft posts to update.
+     * @minSize 1
+     * @maxSize 20
+     */
+    draftPosts?: MaskedDraftPosts[];
+    /**
+     * Action to perform on the posts.
+     *
+     * Default: `UPDATE`
+     */
+    action?: Action;
+    /** Posts' scheduled publish date when `action` is set to `UPDATE_SCHEDULE`. */
+    scheduledPublishDate?: Date | null;
+    /** Whether to return the full updated draft post entities in the response. */
+    returnFullEntity?: boolean;
+    /**
+     * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
+     * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
+     * only the draft post's base fields are returned.
+     * @maxSize 10
+     */
+    fieldsets?: Field[];
+}
 export interface MaskedDraftPosts {
-    /** Draft post info. */
+    /** Draft post */
     draftPost?: DraftPost;
     /** Field mask of fields to update. */
     fieldMask?: string[];
@@ -1848,6 +2229,7 @@ export interface ListDeletedDraftPostsRequest {
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
      * If omitted, deleted draft posts in all languages are returned.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -1862,9 +2244,14 @@ export interface ListDeletedDraftPostsRequest {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
-    /** Draft post ids. */
+    /**
+     * Draft post ids.
+     * @maxSize 100
+     * @format GUID
+     */
     draftPostIds?: string[];
 }
 export declare enum GetDraftPostsSort {
@@ -1886,9 +2273,14 @@ export interface BlogPaging {
      *
      *
      * Default:`50`
+     * @min 1
+     * @max 100
      */
     limit?: number;
-    /** Pointer to the next or previous page in the list of results. */
+    /**
+     * Pointer to the next or previous page in the list of results.
+     * @maxLength 2000
+     */
     cursor?: string | null;
 }
 export interface ListDeletedDraftPostsResponse {
@@ -1904,16 +2296,23 @@ export interface MetaData {
     offset?: number;
     /** Total number of items that match the query. */
     total?: number;
-    /** Pointer to the next or previous page in the list of results. */
+    /**
+     * Pointer to the next or previous page in the list of results.
+     * @maxLength 2000
+     */
     cursor?: string | null;
 }
 export interface GetDraftPostRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
     /**
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -1922,11 +2321,17 @@ export interface GetDraftPostResponse {
     draftPost?: DraftPost;
 }
 export interface UpdateDraftPostContentRequest extends UpdateDraftPostContentRequestDraftContentOneOf {
-    /** DraftJs content to update. */
+    /**
+     * DraftJs content to update.
+     * @maxLength 400000
+     */
     content?: string;
-    /** Draft post rich content. */
+    /** Draft Post rich content. */
     richContent?: RichContent;
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId?: string;
     /** Change origin. */
     changeOrigin?: Origin;
@@ -1934,14 +2339,18 @@ export interface UpdateDraftPostContentRequest extends UpdateDraftPostContentReq
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
 /** @oneof */
 export interface UpdateDraftPostContentRequestDraftContentOneOf {
-    /** DraftJs content to update. */
+    /**
+     * DraftJs content to update.
+     * @maxLength 400000
+     */
     content?: string;
-    /** Draft post rich content. */
+    /** Draft Post rich content. */
     richContent?: RichContent;
 }
 export interface UpdateDraftPostContentResponse {
@@ -1963,6 +2372,7 @@ export interface UpdateDraftPostRequest {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -1971,7 +2381,10 @@ export interface UpdateDraftPostResponse {
     draftPost?: DraftPost;
 }
 export interface DeleteDraftPostRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
     /**
      * Whether to bypass the trash bin and delete the post permanently.
@@ -1983,13 +2396,21 @@ export interface DeleteDraftPostRequest {
 export interface DeleteDraftPostResponse {
 }
 export interface RemoveFromTrashBinRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
 }
 export interface RemoveFromTrashBinResponse {
 }
 export interface BulkDeleteDraftPostsRequest {
-    /** Post IDs. */
+    /**
+     * Post IDs.
+     * @minSize 1
+     * @maxSize 100
+     * @maxLength 38
+     */
     postIds: string[];
     /** Should delete bypassing the trash-bin. */
     permanent?: boolean;
@@ -2013,6 +2434,7 @@ export interface ListDraftPostsRequest {
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
      * If omitted, draft posts in all languages are returned.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -2027,6 +2449,7 @@ export interface ListDraftPostsRequest {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2037,7 +2460,10 @@ export interface ListDraftPostsResponse {
     metaData?: MetaData;
 }
 export interface GetDeletedDraftPostRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
 }
 export interface GetDeletedDraftPostResponse {
@@ -2045,7 +2471,10 @@ export interface GetDeletedDraftPostResponse {
     draftPost?: DraftPost;
 }
 export interface RestoreFromTrashBinRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
 }
 export interface RestoreFromTrashBinResponse {
@@ -2057,13 +2486,17 @@ export interface QueryDraftPostsRequest {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
     /** Query options. */
     query?: PlatformQuery;
 }
 export interface Sorting {
-    /** Name of the field to sort by. */
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
     fieldName?: string;
     /** Sort order. */
     order?: SortOrder;
@@ -2089,6 +2522,7 @@ export interface PlatformQuery extends PlatformQueryPagingMethodOneOf {
     /**
      * Sort object in the following format:
      * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * @maxSize 3
      */
     sort?: Sorting[];
 }
@@ -2100,13 +2534,19 @@ export interface PlatformQueryPagingMethodOneOf {
     cursorPaging?: CursorPaging;
 }
 export interface Paging {
-    /** Number of items to load. */
+    /**
+     * Number of items to load.
+     * @max 100
+     */
     limit?: number | null;
     /** Number of items to skip in the current sort order. */
     offset?: number | null;
 }
 export interface CursorPaging {
-    /** Number of items to load. */
+    /**
+     * Number of items to load.
+     * @max 100
+     */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
@@ -2114,6 +2554,7 @@ export interface CursorPaging {
      * You can get the relevant cursor token
      * from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
+     * @maxLength 2000
      */
     cursor?: string | null;
 }
@@ -2149,167 +2590,50 @@ export interface PagingMetadataV2 {
     cursors?: Cursors;
 }
 export interface Cursors {
-    /** Cursor pointing to next page in the list of results. */
+    /**
+     * Cursor pointing to next page in the list of results.
+     * @maxLength 2000
+     */
     next?: string | null;
-    /** Cursor pointing to previous page in the list of results. */
+    /**
+     * Cursor pointing to previous page in the list of results.
+     * @maxLength 2000
+     */
     prev?: string | null;
 }
 export interface PublishDraftPostRequest {
-    /** Draft post ID. */
+    /**
+     * Draft post ID.
+     * @maxLength 38
+     */
     draftPostId: string;
 }
 export interface PublishDraftPostResponse {
-    /** Published post ID. */
+    /**
+     * Published post ID.
+     * @format GUID
+     */
     postId?: string;
 }
 export interface UnpublishPostRequest {
-    /** Draft post ID. */
-    draftPostId?: string;
-}
-export interface UnpublishPostResponse {
-}
-export interface DomainEvent extends DomainEventBodyOneOf {
-    createdEvent?: EntityCreatedEvent;
-    updatedEvent?: EntityUpdatedEvent;
-    deletedEvent?: EntityDeletedEvent;
-    actionEvent?: ActionEvent;
-    /**
-     * Unique event ID.
-     * Allows clients to ignore duplicate webhooks.
-     */
-    _id?: string;
-    /**
-     * Assumes actions are also always typed to an entity_type
-     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
-     */
-    entityFqdn?: string;
     /**
-     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
-     * This is although the created/updated/deleted notion is duplication of the oneof types
-     * Example: created/updated/deleted/started/completed/email_opened
-     */
-    slug?: string;
-    /** ID of the entity associated with the event. */
-    entityId?: string;
-    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
-    eventTime?: Date | null;
-    /**
-     * Whether the event was triggered as a result of a privacy regulation application
-     * (for example, GDPR).
-     */
-    triggeredByAnonymizeRequest?: boolean | null;
-    /** If present, indicates the action that triggered the event. */
-    originatedFrom?: string | null;
-    /**
-     * A sequence number defining the order of updates to the underlying entity.
-     * For example, given that some entity was updated at 16:00 and than again at 16:01,
-     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
-     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
-     * To do so, you will need to persist this number on your end, and compare the sequence number from the
-     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     * Draft post ID.
+     * @maxLength 38
      */
-    entityEventSequence?: string | null;
-}
-/** @oneof */
-export interface DomainEventBodyOneOf {
-    createdEvent?: EntityCreatedEvent;
-    updatedEvent?: EntityUpdatedEvent;
-    deletedEvent?: EntityDeletedEvent;
-    actionEvent?: ActionEvent;
-}
-export interface EntityCreatedEvent {
-    entity?: string;
+    draftPostId?: string;
 }
-export interface RestoreInfo {
-    deletedDate?: Date | null;
+export interface UnpublishPostResponse {
 }
-export interface EntityUpdatedEvent {
+export interface TranslateCategoryRequest {
     /**
-     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
-     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
-     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     * Source category ID
+     * @format GUID
      */
-    currentEntity?: string;
-}
-export interface EntityDeletedEvent {
-    /** Entity that was deleted */
-    deletedEntity?: string | null;
-}
-export interface ActionEvent {
-    body?: string;
-}
-export interface MessageEnvelope {
-    /** App instance ID. */
-    instanceId?: string | null;
-    /** Event type. */
-    eventType?: string;
-    /** The identification type and identity data. */
-    identity?: IdentificationData;
-    /** Stringify payload. */
-    data?: string;
-}
-export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
-    anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
-    memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
-    wixUserId?: string;
-    /** ID of an app. */
-    appId?: string;
-    /** @readonly */
-    identityType?: WebhookIdentityType;
-}
-/** @oneof */
-export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
-    anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
-    memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
-    wixUserId?: string;
-    /** ID of an app. */
-    appId?: string;
-}
-export declare enum WebhookIdentityType {
-    UNKNOWN = "UNKNOWN",
-    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
-    MEMBER = "MEMBER",
-    WIX_USER = "WIX_USER",
-    APP = "APP"
-}
-export interface GetDraftPostTotalsRequest {
+    categoryId?: string;
     /**
-     * Group results by fields (defaults to grouping by status).
-     * If, for example, grouping by language is passed, language values in response will be filled.
-     * If, for example, grouping by language is not passed, null values will be filled in language field in response.
+     * Translation language
+     * @format LANGUAGE_TAG
      */
-    groupBy?: TotalDraftPostsGroupingField[];
-    /** Optional language filter by provided language code. Useful in multilingual context. */
-    language?: string | null;
-}
-export declare enum TotalDraftPostsGroupingField {
-    /** Groups results by status. */
-    STATUS = "STATUS",
-    /** Groups results by language. */
-    LANGUAGE = "LANGUAGE"
-}
-export interface GetDraftPostTotalsResponse {
-    /** Draft post totals. */
-    totalDraftPosts?: TotalDraftPosts[];
-}
-export interface TotalDraftPosts {
-    /** Draft post totals in that group. */
-    total?: number;
-    /** Draft post status (only has value when grouping by status, otherwise null). */
-    status?: Status;
-    /** Draft post language code (only has value when grouping by language, otherwise null). */
-    language?: string | null;
-}
-export interface TranslateCategoryRequest {
-    /** Source category ID */
-    categoryId?: string;
-    /** Translation language */
     language?: string;
 }
 export interface TranslateCategoryResponse {
@@ -2319,9 +2643,16 @@ export interface TranslateCategoryResponse {
     translations?: CategoryTranslation[];
 }
 export interface Category {
-    /** Category ID. */
+    /**
+     * Category ID.
+     * @immutable
+     * @maxLength 38
+     */
     _id?: string;
-    /** Category label. Displayed in the Category Menu. */
+    /**
+     * Category label. Displayed in the Category Menu.
+     * @maxLength 35
+     */
     label?: string;
     /**
      * Number of posts in the category.
@@ -2333,10 +2664,14 @@ export interface Category {
      * @readonly
      */
     url?: string;
-    /** Category description. */
+    /**
+     * Category description.
+     * @maxLength 500
+     */
     description?: string | null;
     /**
      * Category title.
+     * @maxLength 200
      * @deprecated Category title.
      * @targetRemovalDate 2025-07-16
      */
@@ -2348,19 +2683,27 @@ export interface Category {
      * Default: `-1`
      */
     displayPosition?: number | null;
-    /** ID of the category's translations. All translations of a single category share the same `translationId`. */
+    /**
+     * ID of the category's translations. All translations of a single category share the same `translationId`.
+     * @format GUID
+     */
     translationId?: string | null;
     /**
      * Category language.
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
+     * @immutable
      */
     language?: string | null;
-    /** Part of a category's URL that refers to a specific category. For example, the slug of `https:/example.com/blog/category/famous-cats` is `famous-cats`. */
+    /**
+     * Part of a category's URL that refers to a specific category. For example, the slug of `https:/example.com/blog/category/famous-cats` is `famous-cats`.
+     * @maxLength 100
+     */
     slug?: string;
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxLength 24
      */
     internalId?: string | null;
     /** SEO data. */
@@ -2374,24 +2717,40 @@ export interface Category {
     _updatedDate?: Date | null;
 }
 export interface CategoryTranslation {
-    /** Category ID. */
+    /**
+     * Category ID.
+     * @format GUID
+     */
     _id?: string;
-    /** Label displayed in the categories menu on the site. */
+    /**
+     * Label displayed in the categories menu on the site.
+     * @maxLength 100
+     */
     label?: string | null;
-    /** Language of the category. */
+    /**
+     * Language of the category.
+     * @format LANGUAGE_TAG
+     */
     language?: string | null;
     /** URL of this category page. */
     url?: string;
 }
 export interface TranslateDraftRequest {
-    /** Source post or draft ID */
+    /**
+     * Source post or draft ID
+     * @format GUID
+     */
     postId?: string;
-    /** Translation language */
+    /**
+     * Translation language
+     * @format LANGUAGE_TAG
+     */
     language?: string;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2400,11 +2759,17 @@ export interface TranslateDraftResponse {
     draftPost?: DraftPost;
 }
 export interface IsDraftPostAutoTranslatableRequest {
-    /** Source post or draft ID. */
+    /**
+     * Source post or draft ID.
+     * @format GUID
+     */
     draftPostId?: string;
 }
 export interface IsDraftPostAutoTranslatableResponse {
-    /** Source draft post ID. */
+    /**
+     * Source draft post ID.
+     * @format GUID
+     */
     draftPostId?: string;
     /** Indicates if enough machine translation credits are available for the draft post translation. */
     translatable?: boolean;
@@ -2420,14 +2785,22 @@ export interface IsDraftPostAutoTranslatableResponse {
     contentTextCharacterCount?: number;
 }
 export interface UpdateDraftPostLanguageRequest {
-    /** Source draft post ID */
+    /**
+     * Source draft post ID
+     * @format GUID
+     */
     postId?: string;
-    /** New language to replace to */
+    /**
+     * New language to replace to
+     * @minLength 2
+     * @format LANGUAGE_TAG
+     */
     language?: string;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2436,9 +2809,16 @@ export interface UpdateDraftPostLanguageResponse {
     draftPost?: DraftPost;
 }
 export interface BulkUpdateDraftPostLanguageRequest {
-    /** Source post or draft IDs */
+    /**
+     * Source post or draft IDs
+     * @maxSize 50
+     * @format GUID
+     */
     ids?: string[];
-    /** New language to replace to */
+    /**
+     * New language to replace to
+     * @format LANGUAGE_TAG
+     */
     language?: string;
     /** Should full draft post be returned */
     returnFullEntity?: boolean;
@@ -2446,6 +2826,7 @@ export interface BulkUpdateDraftPostLanguageRequest {
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2456,7 +2837,10 @@ export interface BulkUpdateDraftPostLanguageResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 export interface GetPostAmountsByLanguageRequest {
-    /** Post status to filter by */
+    /**
+     * Post status to filter by
+     * @maxLength 100
+     */
     status?: string;
 }
 export interface GetPostAmountsByLanguageResponse {
@@ -2464,15 +2848,26 @@ export interface GetPostAmountsByLanguageResponse {
     postAmountsByLanguage?: PostAmountByLanguage[];
 }
 export interface PostAmountByLanguage {
-    /** Post language code */
+    /**
+     * Post language code
+     * @format LANGUAGE_TAG
+     */
     languageCode?: string;
-    /** Language flag */
+    /**
+     * Language flag
+     * @format LANGUAGE_TAG
+     */
     flag?: string;
     /** Post amount in that language */
     postAmount?: number;
 }
 export interface BulkRevertToUnpublishedRequest {
-    /** Source post IDs. */
+    /**
+     * Source post IDs.
+     * @minSize 1
+     * @maxSize 100
+     * @format GUID
+     */
     postIds?: string[];
     /** Should full draft post be returned. */
     returnFullEntity?: boolean;
@@ -2484,7 +2879,12 @@ export interface BulkRevertToUnpublishedResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 export interface BulkRejectDraftPostRequest {
-    /** Source post IDs. */
+    /**
+     * Source post IDs.
+     * @minSize 1
+     * @maxSize 100
+     * @format GUID
+     */
     postIds?: string[];
     /** Should full draft post be returned. */
     returnFullEntity?: boolean;
@@ -2496,12 +2896,16 @@ export interface BulkRejectDraftPostResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 export interface RevertToUnpublishedRequest {
-    /** Source post ID. */
+    /**
+     * Source post ID.
+     * @format GUID
+     */
     postId?: string;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2510,12 +2914,16 @@ export interface RevertToUnpublishedResponse {
     draftPost?: DraftPost;
 }
 export interface RejectDraftPostRequest {
-    /** Source post ID. */
+    /**
+     * Source post ID.
+     * @format GUID
+     */
     postId?: string;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2524,14 +2932,21 @@ export interface RejectDraftPostResponse {
     draftPost?: DraftPost;
 }
 export interface ApproveDraftPostRequest {
-    /** Source post ID. */
+    /**
+     * Source post ID.
+     * @format GUID
+     */
     postId?: string;
-    /** Scheduled publish date if should be not immediately published. */
+    /**
+     * Scheduled publish date if should be not immediately published.
+     * @maxLength 24
+     */
     scheduledPublishDate?: string | null;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2540,12 +2955,16 @@ export interface ApproveDraftPostResponse {
     draftPost?: DraftPost;
 }
 export interface MarkPostAsInModerationRequest {
-    /** Source post ID. */
+    /**
+     * Source post ID.
+     * @maxLength 38
+     */
     postId?: string;
     /**
      * List of draft post fields to be included if entities are present in the response.
      * Base fieldset, which is default, will return all core draft post properties.
      * Example: When URL fieldset is selected, returned draft post will have a set of base properties and draft post preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -2642,9 +3061,13 @@ interface ImageDataNonNullableFields {
     containerData?: PluginContainerDataNonNullableFields;
     link?: LinkNonNullableFields;
 }
+interface LinkPreviewDataStylesNonNullableFields {
+    thumbnailPosition: Position;
+}
 interface LinkPreviewDataNonNullableFields {
     containerData?: PluginContainerDataNonNullableFields;
     link?: LinkNonNullableFields;
+    styles?: LinkPreviewDataStylesNonNullableFields;
 }
 interface MapSettingsNonNullableFields {
     mapType: MapType;
@@ -2948,9 +3371,15 @@ export interface PublishDraftPostResponseNonNullableFields {
     postId: string;
 }
 export interface BaseEventMetadata {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -3068,7 +3497,7 @@ export declare function onDraftUpdated(handler: (event: DraftUpdatedEnvelope) =>
 /**
  * Creates a draft post.
  *
- * The draft post's `memberId` is required for third-party apps.
+ * A draft post's [memberId](https://dev.wix.com/api/rest/members/members) is required for 3rd-party apps.
  * @param draftPost - Draft post to create.
  * @public
  * @requiredField draftPost
@@ -3092,6 +3521,7 @@ export interface CreateDraftPostOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -3118,6 +3548,7 @@ export interface BulkCreateDraftPostsOptions {
      * List of draft post fields to be included in the response if the entities are present.
      * Base default fieldset returns all core draft post properties (all properties that are not a supported fieldset value).
      * For example,  when `URL` fieldset is selected, returned draft post will include the set of base properties and the draft post's preview url.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -3135,19 +3566,15 @@ export interface BulkCreateDraftPostsOptions {
  */
 export declare function bulkUpdateDraftPosts(options?: BulkUpdateDraftPostsOptions): Promise<BulkUpdateDraftPostsResponse & BulkUpdateDraftPostsResponseNonNullableFields>;
 export interface BulkUpdateDraftPostsOptions {
-    /** Draft posts to update. */
+    /**
+     * Draft posts to update.
+     * @minSize 1
+     * @maxSize 20
+     */
     draftPosts?: MaskedDraftPosts[];
     /**
      * 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;
@@ -3159,13 +3586,14 @@ export interface BulkUpdateDraftPostsOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
 /**
  * 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`.
@@ -3184,6 +3612,7 @@ export interface ListDeletedDraftPostsOptions {
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
      * If omitted, deleted draft posts in all languages are returned.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -3198,15 +3627,18 @@ export interface ListDeletedDraftPostsOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
-    /** Draft post ids. */
+    /**
+     * Draft post ids.
+     * @maxSize 100
+     * @format GUID
+     */
     draftPostIds?: string[];
 }
 /**
  * Gets a draft post by the provided ID.
- *
- * Uses the provided `draftPostId` to retrieve a draft post.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3223,6 +3655,7 @@ export interface GetDraftPostOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[];
 }
@@ -3245,24 +3678,40 @@ export interface UpdateDraftPost {
     /**
      * Draft post ID.
      * @readonly
+     * @maxLength 38
      */
     _id?: string;
-    /** Draft post title. */
+    /**
+     * Draft post title.
+     * @maxLength 200
+     */
     title?: string;
     /**
      * Draft post excerpt.
      *
      * If no excerpt has been manually set, an excerpt is automatically generated from the post's text.
      * This can be retrieved using the `GENERATED_EXCERPT` fieldset.
+     * @maxLength 500
      */
     excerpt?: string | null;
     /** Whether the draft post is marked as featured. */
     featured?: boolean | null;
-    /** Category IDs of the draft post. */
+    /**
+     * Category IDs of the draft post.
+     * @maxSize 10
+     * @maxLength 38
+     */
     categoryIds?: string[];
-    /** Draft post owner's member ID. */
+    /**
+     * Draft post owner's member ID.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Hashtags in the draft post. */
+    /**
+     * Hashtags in the post.
+     * @maxSize 100
+     * @maxLength 100
+     */
     hashtags?: string[];
     /** Whether commenting on the draft post is enabled. */
     commentingEnabled?: boolean | null;
@@ -3273,23 +3722,37 @@ export interface UpdateDraftPost {
     minutesToRead?: number;
     /** Image placed at the top of the blog page. */
     heroImage?: string;
-    /** Tag IDs the draft post is tagged with. */
+    /**
+     * Tag IDs the draft post is tagged with.
+     * @maxSize 30
+     * @maxLength 38
+     */
     tagIds?: string[];
-    /** IDs of posts related to this draft post. */
+    /**
+     * IDs of posts related to this draft post.
+     * @maxSize 3
+     * @maxLength 38
+     */
     relatedPostIds?: string[];
-    /** Pricing plan IDs. Only relevant if a post is assigned to a specific pricing plan. */
+    /**
+     * [Pricing plan IDs](https://dev.wix.com/api/rest/wix-pricing-plans). Only relevant if a post is assigned to a specific pricing plan.
+     * @maxSize 100
+     * @format GUID
+     */
     pricingPlanIds?: string[];
     /**
      * ID of the draft post's translations.
      *
      * All translations of a single post share the same `translationId`.
      * Available only if the [Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) app is installed.
+     * @format GUID
      */
     translationId?: string | null;
     /**
      * Language the draft post is written in.
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -3300,11 +3763,21 @@ export interface UpdateDraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxLength 24
      */
     contentId?: string | null;
-    /** Reserved for internal use. */
+    /**
+     * Reserved for internal use.
+     * @format GUID
+     */
     editingSessionId?: string | null;
-    /** Draft post rich content. */
+    /**
+     * 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>
+     */
     richContent?: RichContent;
     /**
      * Status of the draft post.
@@ -3316,6 +3789,7 @@ export interface UpdateDraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @format GUID
      */
     mostRecentContributorId?: string | null;
     /**
@@ -3340,8 +3814,7 @@ export interface UpdateDraftPost {
     /** SEO data. */
     seoData?: SeoSchema;
     /**
-     * @internal Deprecated.
-     * @internal Deprecated.
+     * Reserved for internal use.
      * @deprecated
      * @replacedBy preview_text_paragraph
      * @targetRemovalDate 2024-06-30
@@ -3350,6 +3823,8 @@ export interface UpdateDraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxSize 5000
+     * @maxLength 100
      */
     slugs?: string[];
     /**
@@ -3362,7 +3837,10 @@ export interface UpdateDraftPost {
      * @readonly
      */
     _createdDate?: Date | null;
-    /** SEO slug. */
+    /**
+     * SEO slug.
+     * @maxLength 100
+     */
     seoSlug?: string | null;
     /** Post cover media. */
     media?: Media;
@@ -3371,6 +3849,7 @@ export interface UpdateDraftPost {
     /**
      * Reserved for internal use.
      * @readonly
+     * @maxLength 24
      */
     internalId?: string | null;
 }
@@ -3387,14 +3866,15 @@ export interface UpdateDraftPostOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     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`](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats).
  *
- * 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
@@ -3415,9 +3895,7 @@ export interface DeleteDraftPostOptions {
     permanent?: boolean;
 }
 /**
- * Permanently deletes a draft post by the provided ID from 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.
+ * Permanently deletes a draft post that is currently in the trash bin.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3474,6 +3952,7 @@ export interface ListDraftPostsOptions {
      *
      * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
      * If omitted, draft posts in all languages are returned.
+     * @format LANGUAGE_TAG
      */
     language?: string | null;
     /**
@@ -3488,13 +3967,12 @@ export interface ListDraftPostsOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     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.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId
@@ -3507,8 +3985,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
@@ -3520,12 +3996,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
@@ -3540,6 +4024,7 @@ export interface QueryDraftPostsOptions {
      * List of additional draft post fields to include in the response. For example, use the `URL` fieldset to retrieve the url field in
      * the response in addition to the draft post's base fields. Base fields don’t include any of the supported fieldset values. By default
      * only the draft post's base fields are returned.
+     * @maxSize 10
      */
     fieldsets?: Field[] | undefined;
 }
@@ -3598,9 +4083,9 @@ 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.
- *
- * If the specified draft post was already published, the published post will be updated with the latest values from the draft post entity.
+ * Publishes a specified draft post by ID. This creates a new [post](https://dev.wix.com/docs/rest/business-solutions/blog/posts-stats) entity 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.
  * @param draftPostId - Draft post ID.
  * @public
  * @requiredField draftPostId