@wix/categories 1.0.39 → 1.0.41

package/type-bundles/meta.bundle.d.ts

@@ -1,23 +1,21 @@
-/**
- * A Category is the main entity of CategoriesService that can be created, customized and managed by the user.
- * Category can be organized into a hierarchical tree structure by assigning a parent category.
- * This structure can then be used to group similar items in order to make it easier for clients to find them.
- */
 interface Category$1 {
     /** Category ID. */
     id?: string | null;
     /**
-     * Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision
+     * Revision number, which increments by 1 each time the category is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating.
+     *
+     * Ignored when creating a category.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Represents the time this Category was created.
+     * Date and time the category was created.
      * @readonly
      */
     createdDate?: Date;
     /**
-     * Represents the time this Category was last updated.
+     * Date and time the category was updated.
      * @readonly
      */
     updatedDate?: Date;
@@ -25,51 +23,62 @@ interface Category$1 {
     name?: string | null;
     /**
      * Category image.
-     * Pass existing media ID for image previously saved in Wix media manager.
-     * Pass full image URL to upload an image to Wix media manager.
-     * In case of full url the image will be updated eventually.
+     *
+     * + Pass WixMedia image ID for media previously saved in the [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager).
+     * + Pass full image URL to upload to Wix Media Manager.
      */
     image?: Image$1;
     /**
-     * Number of items in this category alone.
+     * Number of items in this category.
      * @readonly
      */
     itemCounter?: number;
-    /** Category description. */
+    /**
+     * Category description.
+     * > **Note:** This field is returned only when you pass `fields: "DESCRIPTION"` in the request.
+     */
     description?: string | null;
     /**
-     * Whether the category is visible to site visitors in dynamic pages (If not passed, the default is `false`).
-     * Even if visible is `false`, it can still be added manually to static page.
-     * If parent visibility is updated to `false`, all the children visibility will be updated eventually to `false`.
-     * It is not allowed to set visible as `true` if at least one of the parent categories has visible `false`.
+     * Whether the category is visible to site visitors in dynamic pages.
+     *
+     * + If the parent category's visibility is set to `false`, all the children categories' visibility will also be set to `false`.
+     * + Passing `true` will fail if the visibility of any parent categories is `false`.
+     * + Default: `false`.
      */
     visible?: boolean | null;
     /**
-     * A category's breadcrumbs, Updated on moved to different parent or on renamed.
-     * > **Note:** This field is returned only when you pass `fields: "BREADCRUMBS"` in the request.
+     * Category breadcrumbs.
+     *
+     * > **Note:** Returned only when you pass `"BREADCRUMBS"` to the `fields` array in Categories API requests.
      * @readonly
      */
     breadcrumbs?: BreadcrumbItemValues$1;
-    /** The parent category. */
+    /** Parent category reference data. */
     parentCategory?: ParentCategory$1;
     /**
-     * A permanent, friendly URL name.
-     * If not provided, on create generated automatically.
-     * When provided, validated and must be unique.
+     * Category slug.
+     *
+     * If not provided, the slug is autogenerated based on the category name.
      */
     slug?: string | null;
     /**
-     * Category description which supports rich content. It is independent from `description` field and can be used instead of it or in addition to it.
-     * In order to use this field you have to integrate with "Ricos" on frontend side. To learn how to do it visit https://ricos.js.org/.
+     * Category description using rich content.
+     *
+     * Learn more about [Working with Rich Content](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content).
+     * > **Note:** Returned only when you pass `"BREADCRUMBS"` to the `fields` array in Categories API requests.
      */
     richContentDescription?: RichContent$1;
     /**
-     * Optional - the ID of the app responsible for managing the items within this category.
-     * If provided, the update of items assigned to this category and the deletion of it will be allowed only to the managing app.
-     * The default is Empty.
+     * ID of the app responsible for managing the items in this category.
+     *
+     * Pass your app ID to restrict updating and deleting items in this category to your app only.
      */
     managingAppId?: string | null;
-    /** Extensions enabling users to save custom data related to the category. */
+    /**
+     * Custom extended fields for the category object.
+     *
+     * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the Wix Dev Center before they can be accessed with API calls.
+     */
     extendedFields?: ExtendedFields$1;
 }
 interface Image$1 {
@@ -95,30 +104,30 @@ interface Image$1 {
      */
     filename?: string | null;
 }
-/** Wrapper for optional BreadcrumbItem values */
 interface BreadcrumbItemValues$1 {
     /**
-     * The wrapped BreadcrumbItem values
+     * List of breadcrumb data.
      * @readonly
      */
     values?: BreadcrumbItem$1[];
 }
 interface BreadcrumbItem$1 {
-    /** Represents the id of the category. */
+    /** Category ID. */
     categoryId?: string;
-    /** Represents the name of the category. Translatable */
+    /** Category name. */
     categoryName?: string;
-    /** Represents the slug. A permanent, friendly URL name of the category. */
+    /** Category slug. */
     categorySlug?: string;
 }
 interface ParentCategory$1 {
     /**
-     * Represents the id of the parent category.
-     * If not passed, the default is the root category.
+     * Parent category ID.
+     *
+     * Default: root category ID
      */
     id?: string | null;
     /**
-     * Represents the index of current category within the parent category.
+     * Index position of the category within the parent category.
      * @readonly
      */
     index?: number | null;
@@ -1335,12 +1344,12 @@ interface TextNodeStyle$1 {
 }
 interface TreeReference$1 {
     /**
-     * The unique namespace of an app in dev-center that owns this tree.
-     * Should meet the format of @company/app1 where @company is an organizational unit and app1 is the app name.
-     * For example: @bookings/bookingslist, @achievements/quizzes
+     * Namespace of the app that manages the tree.
+     *
+     * For example, `"@wix/stores"`, `"@bookings/bookingslist"`, `"@achievements/quizzes"`.
      */
     appNamespace?: string;
-    /** Optional - The key of the tree. Must be provided when single app manages more than one tree. */
+    /** Tree key. You must pass this when a single app manages more than one tree. */
     treeKey?: string | null;
 }
 interface ExtendedFields$1 {
@@ -1354,54 +1363,139 @@ interface ExtendedFields$1 {
      */
     namespaces?: Record<string, Record<string, any>>;
 }
+interface ItemReference$1 {
+    /**
+     * ID of the item within the catalog it belongs to.
+     *
+     * For example, `product.id` for Wix Stores or `event.id` for Wix Events.
+     */
+    catalogItemId?: string;
+    /**
+     * ID of the app providing the catalog.
+     *
+     * You can get your app's ID from its page in the [Wix Dev Center](https://dev.wix.com/apps).
+     *
+     * For items from Wix catalogs, the following values always apply:
+     * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
+     * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
+     * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
+     */
+    appId?: string;
+}
 interface CreateCategoryRequest$1 {
-    /** Category to be created. */
+    /** Category to create. */
     category: Category$1;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields$1[];
 }
 declare enum SingleEntityOpsRequestedFields$1 {
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
-    BREADCRUMBS = "BREADCRUMBS"
+    BREADCRUMBS = "BREADCRUMBS",
+    DESCRIPTION = "DESCRIPTION",
+    RICH_CONTENT_DESCRIPTION = "RICH_CONTENT_DESCRIPTION"
 }
 interface CreateCategoryResponse$1 {
-    /** The created Category. */
+    /** Created category. */
     category?: Category$1;
 }
 interface GetCategoryRequest$1 {
-    /** Id of the Category to retrieve. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields$1[];
 }
 interface GetCategoryResponse$1 {
-    /** The retrieved Category. */
+    /** Category. */
     category?: Category$1;
 }
 interface UpdateCategoryRequest$1 {
-    /** Category to be updated, may be partial. */
+    /** Category to update. */
     category: Category$1;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields$1[];
 }
 interface UpdateCategoryResponse$1 {
-    /** The updated Category. */
+    /** Updated category. */
     category?: Category$1;
 }
 interface DeleteCategoryRequest$1 {
-    /** Id of the Category to delete. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface DeleteCategoryResponse$1 {
 }
+interface QueryCategoriesRequest$1 {
+    /** Query options. */
+    query?: CursorQuery$1;
+    /** Category tree reference details. */
+    treeReference: TreeReference$1;
+    /**
+     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
+     * Used only in the first request. Following requests use the cursor token.
+     */
+    returnNonVisibleCategories?: boolean;
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
+    fields?: RequestedFields$1[];
+}
+interface CursorQuery$1 extends CursorQueryPagingMethodOneOf$1 {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging$1;
+    /**
+     * Filter object in the following format:
+     * `"filter" : {
+     * "fieldName1": "value1",
+     * "fieldName2":{"$operator":"value2"}
+     * }`
+     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the following format:
+     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     */
+    sort?: Sorting$1[];
+}
+/** @oneof */
+interface CursorQueryPagingMethodOneOf$1 {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging$1;
+}
 interface Sorting$1 {
     /** Name of the field to sort by. */
     fieldName?: string;
@@ -1427,20 +1521,46 @@ declare enum RequestedFields$1 {
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     BREADCRUMBS = "BREADCRUMBS"
 }
+interface QueryCategoriesResponse$1 {
+    /** Categories which satisfy the provided query. */
+    categories?: Category$1[];
+    /** Paging metadata. Contains cursor which can be used in next query. */
+    pagingMetadata?: PlatformPagingMetadataV2$1;
+}
+interface PlatformPagingMetadataV2$1 {
+    /** The number of items returned in this response. */
+    count?: number | null;
+    /** Cursors to navigate through result pages. Returned if cursor paging was used. */
+    cursors?: CommonCursors$1;
+}
+interface CommonCursors$1 {
+    /** Cursor string pointing to the next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to the previous page in the list of results. */
+    prev?: string | null;
+}
 interface SearchCategoriesRequest$1 {
-    /** WQL query expression. */
+    /** Search options. */
     search?: CursorSearch$1;
     /**
-     * A reference to the tree that contains this category.
-     * Used only in the first request. Following requests use the cursor token.
+     * Category tree reference details.
+     * > **Note:** Pass `treeReference` only in the first request. Pass the cursor token in subsequent requests.
      */
     treeReference: TreeReference$1;
     /**
-     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
-     * Used only in the first request. Following requests use the cursor token.
+     * Whether to return the categories with `visible: false`.
+     *
+     * Default: `false` - only visible categories are returned in the response
      */
     returnNonVisibleCategories?: boolean;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: RequestedFields$1[];
 }
 interface CursorSearch$1 extends CursorSearchPagingMethodOneOf$1 {
@@ -1651,13 +1771,23 @@ interface NestedAggregation$1 {
     nestedAggregations?: NestedAggregationItem$1[];
 }
 interface SearchDetails$1 {
-    /** Defines how separate search terms in `expression` are combined */
+    /**
+     * Defines how separate search terms in `expression` are combined.
+     *
+     * Supported values:
+     * + `OR` - Any of the search terms must be present
+     * + `AND` - All search terms must be present
+     */
     mode?: Mode$1;
-    /** Search term or expression */
+    /** Search term or expression. */
     expression?: string | null;
-    /** Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path */
+    /**
+     * Fields in which to search for the `expression`. Use dot notation to specify field path.
+     *
+     * When empty - all searchable fields are looked at.
+     */
     fields?: string[];
-    /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
+    /** Whether to use fuzzy search - allowing typos and other minor errors in the search. */
     fuzzy?: boolean;
 }
 declare enum Mode$1 {
@@ -1667,9 +1797,9 @@ declare enum Mode$1 {
     AND = "AND"
 }
 interface SearchCategoriesResponse$1 {
-    /** Categories which satisfy the provided query. */
+    /** List of categories. */
     categories?: Category$1[];
-    /** Paging metadata. Contains cursor which can be used in next query. */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata$1;
     /** Aggregation data. */
     aggregationData?: AggregationData$1;
@@ -1856,63 +1986,68 @@ interface AggregationResultsResultOneOf$1 {
 }
 interface CountCategoriesRequest$1 {
     /**
-     * A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
-     * To understand supported filters and limitations see `SearchCategories` method.
+     * Filter object.
+     *
+     * Learn more about the [filter object structure](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
-    /** free text to match in searchable fields */
+    /** Search options. */
     search?: SearchDetails$1;
-    /**
-     * A reference to the tree that contains this category.
-     * Used only in the first request. Following requests use the cursor token.
-     */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
     /**
-     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
-     * Used only in the first request. Following requests use the cursor token.
+     * Whether to return categories with `visible: false` (hidden categories).
+     *
+     * Default: `false` - only visible categories are returned in the response
      */
     returnNonVisibleCategories?: boolean;
 }
 interface CountCategoriesResponse$1 {
-    /** Total count of categories which satisfy the provided request. */
+    /** Total count of categories which satisfy the given filter and/or search. */
     count?: number;
 }
 interface MoveCategoryRequest$1 {
-    /** ID of category to place. */
+    /** ID of the category to move. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
     /**
-     * ID of parent category.
-     * Optional. When not passed it will fallback to the root category
+     * Parent category ID.
+     *
+     * Default: root category ID
      */
     parentCategoryId?: string | null;
     /**
      * Where to place the subcategory.
-     * `FIRST` - make category with `category_id` first subcategory with manual arrangement.
-     * `LAST` - make category with `category_id` last subcategory with manual arrangement.
-     * `BEFORE` - requires `move_before_category_id`, category with `category_id` will be moved before it.
+     *
+     * + `FIRST`: Position the category as the first subcategory.
+     * + `LAST`: Position the category as the last subcategory.
+     * + `AFTER`: Position the category after the category ID passed in `moveAfterCategoryId`.
      */
     position: Position$1;
-    /** Required when `position` is `BEFORE`. Otherwise ignored */
-    moveBeforeCategoryId?: string | null;
+    /** Required when passing `position: AFTER`. */
+    moveAfterCategoryId?: string | null;
 }
 declare enum Position$1 {
     UNKNOWN_POSITION = "UNKNOWN_POSITION",
     FIRST = "FIRST",
     LAST = "LAST",
-    BEFORE = "BEFORE"
+    AFTER = "AFTER"
 }
 interface MoveCategoryResponse$1 {
-    /** ID of parent category. */
+    /** Parent category ID. */
     parentCategoryId?: string | null;
-    /** Information about manually arranged categories after move. */
+    /** List of category IDs in the new order of arrangement. */
     categoriesAfterMove?: string[];
 }
 interface BulkCategoriesResult$1 {
-    /** Information about successful action or error for failure. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemMetadata$1;
-    /** Created or updated category. Optional - returned only if requested with `return_entity` set to `true`. */
+    /**
+     * Full category entity.
+     *
+     * Returned only if `returnEntity: true` is passed in the request.
+     */
     category?: Category$1;
 }
 interface ItemMetadata$1 {
@@ -1942,17 +2077,28 @@ interface BulkActionMetadata$1 {
     undetailedFailures?: number;
 }
 interface BulkUpdateCategoriesRequest$1 {
-    /** List of categories to be updated. */
+    /** List of categories to update. */
     categories: MaskedCategory$1[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Whether to return the category entity in the response. */
+    /**
+     * Whether to return the full category entity in the response.
+     *
+     * Default: `false`
+     */
     returnEntity?: boolean;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: RequestedFields$1[];
 }
 interface MaskedCategory$1 {
-    /** Category to be updated, may be partial. */
+    /** Category to update. */
     category?: Category$1;
 }
 interface BulkUpdateCategoriesResponse$1 {
@@ -1962,61 +2108,73 @@ interface BulkUpdateCategoriesResponse$1 {
     bulkActionMetadata?: BulkActionMetadata$1;
 }
 interface UpdateCategoryVisibilityRequest$1 {
-    /** ID of category to be updated */
+    /** Category ID. */
     categoryId: string;
-    /** value to set `visible` to */
+    /**
+     * Whether the category is visible to site visitors in dynamic pages.
+     *
+     * + If a parent category's visibility is set to `false`, all the children categories' visibility will also be set to `false`.
+     * + Passing `true` will fail if the visibility of any parent categories is `false`.
+     */
     visible: boolean;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Latest revision of the category. */
+    /**
+     * Latest revision of the category.
+     * To prevent conflicting changes, the current revision must be passed on update.
+     */
     revision: string | null;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields$1[];
 }
 interface UpdateCategoryVisibilityResponse$1 {
-    /** The updated Category. */
+    /** Updated category. */
     category?: Category$1;
 }
 interface BulkAddItemsToCategoryRequest$1 {
-    /** Category id. */
+    /** Category ID. */
     categoryId: string;
-    /** List of catalog items with reference info. */
+    /** List of items to add. */
     items: ItemReference$1[];
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
-interface ItemReference$1 {
-    /** ID of the item within its Wix or 3rd-party catalog. For example, `productId` for Wix Stores or `eventId` for Wix Events. */
-    catalogItemId?: string;
-    /** ID of the catalog app. For example, the Wix Stores `appId`, or the 3rd-party `appId`. */
-    appId?: string;
-}
 interface BulkAddItemsToCategoryResponse$1 {
-    /** Items added by bulk action. */
+    /** List of items added to a category by bulk action. */
     results?: BulkItemsToCategoryResult$1[];
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata$1;
 }
 interface BulkItemsToCategoryResult$1 {
-    /** Information about items that were added successfully and errors for failed items. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemReferenceMetadata$1;
 }
 interface ItemReferenceMetadata$1 {
-    /** Item reference from request. */
+    /** Catalog and item reference info. */
     item?: ItemReference$1;
-    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    /** Original 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. */
+    /**
+     * Whether the action was successful.
+     * When `false`, the `error` field is populated.
+     */
     success?: boolean;
-    /** Details about the error in case of failure. */
+    /** Error details in the case of an unsuccessful action. */
     error?: ApplicationError$1;
 }
 interface BulkAddItemToCategoriesRequest$1 {
-    /** Catalog item reference info */
+    /** Item to add. */
     item: ItemReference$1;
-    /** Category ids. */
+    /** IDs of categories to which to add the item. */
     categoryIds: string[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface BulkAddItemToCategoriesResponse$1 {
@@ -2026,15 +2184,15 @@ interface BulkAddItemToCategoriesResponse$1 {
     bulkActionMetadata?: BulkActionMetadata$1;
 }
 interface BulkItemToCategoriesResult$1 {
-    /** Information about categories to which item was added successfully and errors for failed items. `id` is ID of category. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemMetadata$1;
 }
 interface BulkRemoveItemsFromCategoryRequest$1 {
-    /** Category id */
+    /** Category ID. */
     categoryId: string;
-    /** List of catalog items with reference info. */
+    /** List of items to remove. */
     items: ItemReference$1[];
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface BulkRemoveItemsFromCategoryResponse$1 {
@@ -2044,11 +2202,11 @@ interface BulkRemoveItemsFromCategoryResponse$1 {
     bulkActionMetadata?: BulkActionMetadata$1;
 }
 interface BulkRemoveItemFromCategoriesRequest$1 {
-    /** Catalog item reference info */
+    /** Item to remove. */
     item: ItemReference$1;
-    /** Category ids. */
+    /** IDs of categories from which to remove the item. */
     categoryIds: string[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface BulkRemoveItemFromCategoriesResponse$1 {
@@ -2058,26 +2216,42 @@ interface BulkRemoveItemFromCategoriesResponse$1 {
     bulkActionMetadata?: BulkActionMetadata$1;
 }
 interface ListItemsInCategoryRequest$1 extends ListItemsInCategoryRequestPagingMethodOneOf$1 {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `use_category_arrangement` or `include_items_from_subcategories`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging$1;
-    /** ID of category containing items. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /** Default: `false`. When `true` items arranged by user will be return before all other items. */
+    /**
+     * Whether to use category arrangement for sorting items.
+     *
+     * Default: `false`
+     */
     useCategoryArrangement?: boolean;
-    /** Default: `false`. When `false` only direct items of category will be returned. When `true` response contains also items from all subcategories which current category contains */
+    /**
+     * Whether to include items from subcategories.
+     *
+     * Default: `false` (only direct items of the category will be returned)
+     */
     includeItemsFromSubcategories?: boolean;
 }
 /** @oneof */
 interface ListItemsInCategoryRequestPagingMethodOneOf$1 {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `use_category_arrangement` or `include_items_from_subcategories`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging$1;
 }
 interface ListItemsInCategoryResponse$1 {
-    /** Items which satisfy query. */
+    /** List of items in the category. */
     items?: ItemReference$1[];
-    /** Paging metadata. Contains cursor which can be used in next query. */
+    /** Paging metadata. */
     pagingMetadata?: PagingMetadataV2$1;
 }
 interface PagingMetadataV2$1 {
@@ -2091,46 +2265,43 @@ interface PagingMetadataV2$1 {
     cursors?: Cursors$1;
 }
 interface ListCategoriesForItemRequest$1 {
-    /** Catalog item reference info. */
+    /** Item reference info. */
     item: ItemReference$1;
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface ListCategoriesForItemResponse$1 {
-    /** A list of category IDs that contain this item directly. */
+    /** List of IDs of categories that directly contain this item. */
     directCategoryIds?: string[];
-    /** A list of category IDs that contain this item directly and their parent category IDs. */
+    /** List of IDs of categories that directly contain this item, and their parent category IDs. */
     allCategoryIds?: string[];
 }
 interface ListTreesRequest$1 {
 }
 interface ListTreesResponse$1 {
-    /** A list of all trees */
+    /** List of trees. */
     trees?: TreeReference$1[];
 }
 interface SetArrangedItemsRequest$1 {
-    /** ID of category. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
-    /**
-     * List of arranged items to set.
-     * All items must be direct children of category with `category_id`, otherwise error returned.
-     */
+    /** List of items to set. */
     items?: ItemReference$1[];
 }
 interface SetArrangedItemsResponse$1 {
-    /** The updated list of arranged items in category. */
+    /** List of arranged items. */
     items?: ItemReference$1[];
 }
 interface GetArrangedItemsRequest$1 {
-    /** ID of category. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference$1;
 }
 interface GetArrangedItemsResponse$1 {
-    /** List of arranged items in category. */
+    /** List of arranged items. */
     items?: ItemReference$1[];
 }
 interface ImageNonNullableFields$1 {
@@ -2429,6 +2600,9 @@ interface GetCategoryResponseNonNullableFields$1 {
 interface UpdateCategoryResponseNonNullableFields$1 {
     category?: CategoryNonNullableFields$1;
 }
+interface QueryCategoriesResponseNonNullableFields$1 {
+    categories: CategoryNonNullableFields$1[];
+}
 interface ValueAggregationResultNonNullableFields$1 {
     value: string;
     count: number;
@@ -2565,26 +2739,24 @@ interface GetArrangedItemsResponseNonNullableFields$1 {
     items: ItemReferenceNonNullableFields$1[];
 }
 
-/**
- * A Category is the main entity of CategoriesService that can be created, customized and managed by the user.
- * Category can be organized into a hierarchical tree structure by assigning a parent category.
- * This structure can then be used to group similar items in order to make it easier for clients to find them.
- */
 interface Category {
     /** Category ID. */
     _id?: string | null;
     /**
-     * Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision
+     * Revision number, which increments by 1 each time the category is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating.
+     *
+     * Ignored when creating a category.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Represents the time this Category was created.
+     * Date and time the category was created.
      * @readonly
      */
     _createdDate?: Date;
     /**
-     * Represents the time this Category was last updated.
+     * Date and time the category was updated.
      * @readonly
      */
     _updatedDate?: Date;
@@ -2592,77 +2764,88 @@ interface Category {
     name?: string | null;
     /**
      * Category image.
-     * Pass existing media ID for image previously saved in Wix media manager.
-     * Pass full image URL to upload an image to Wix media manager.
-     * In case of full url the image will be updated eventually.
+     *
+     * + Pass WixMedia image ID for media previously saved in the [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager).
+     * + Pass full image URL to upload to Wix Media Manager.
      */
     image?: string;
     /**
-     * Number of items in this category alone.
+     * Number of items in this category.
      * @readonly
      */
     itemCounter?: number;
-    /** Category description. */
+    /**
+     * Category description.
+     * > **Note:** This field is returned only when you pass `fields: "DESCRIPTION"` in the request.
+     */
     description?: string | null;
     /**
-     * Whether the category is visible to site visitors in dynamic pages (If not passed, the default is `false`).
-     * Even if visible is `false`, it can still be added manually to static page.
-     * If parent visibility is updated to `false`, all the children visibility will be updated eventually to `false`.
-     * It is not allowed to set visible as `true` if at least one of the parent categories has visible `false`.
+     * Whether the category is visible to site visitors in dynamic pages.
+     *
+     * + If the parent category's visibility is set to `false`, all the children categories' visibility will also be set to `false`.
+     * + Passing `true` will fail if the visibility of any parent categories is `false`.
+     * + Default: `false`.
      */
     visible?: boolean | null;
     /**
-     * A category's breadcrumbs, Updated on moved to different parent or on renamed.
-     * > **Note:** This field is returned only when you pass `fields: "BREADCRUMBS"` in the request.
+     * Category breadcrumbs.
+     *
+     * > **Note:** Returned only when you pass `"BREADCRUMBS"` to the `fields` array in Categories API requests.
      * @readonly
      */
     breadcrumbs?: BreadcrumbItemValues;
-    /** The parent category. */
+    /** Parent category reference data. */
     parentCategory?: ParentCategory;
     /**
-     * A permanent, friendly URL name.
-     * If not provided, on create generated automatically.
-     * When provided, validated and must be unique.
+     * Category slug.
+     *
+     * If not provided, the slug is autogenerated based on the category name.
      */
     slug?: string | null;
     /**
-     * Category description which supports rich content. It is independent from `description` field and can be used instead of it or in addition to it.
-     * In order to use this field you have to integrate with "Ricos" on frontend side. To learn how to do it visit https://ricos.js.org/.
+     * Category description using rich content.
+     *
+     * Learn more about [Working with Rich Content](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content).
+     * > **Note:** Returned only when you pass `"BREADCRUMBS"` to the `fields` array in Categories API requests.
      */
     richContentDescription?: RichContent;
     /**
-     * Optional - the ID of the app responsible for managing the items within this category.
-     * If provided, the update of items assigned to this category and the deletion of it will be allowed only to the managing app.
-     * The default is Empty.
+     * ID of the app responsible for managing the items in this category.
+     *
+     * Pass your app ID to restrict updating and deleting items in this category to your app only.
      */
     managingAppId?: string | null;
-    /** Extensions enabling users to save custom data related to the category. */
+    /**
+     * Custom extended fields for the category object.
+     *
+     * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the Wix Dev Center before they can be accessed with API calls.
+     */
     extendedFields?: ExtendedFields;
 }
-/** Wrapper for optional BreadcrumbItem values */
 interface BreadcrumbItemValues {
     /**
-     * The wrapped BreadcrumbItem values
+     * List of breadcrumb data.
      * @readonly
      */
     values?: BreadcrumbItem[];
 }
 interface BreadcrumbItem {
-    /** Represents the id of the category. */
+    /** Category ID. */
     categoryId?: string;
-    /** Represents the name of the category. Translatable */
+    /** Category name. */
     categoryName?: string;
-    /** Represents the slug. A permanent, friendly URL name of the category. */
+    /** Category slug. */
     categorySlug?: string;
 }
 interface ParentCategory {
     /**
-     * Represents the id of the parent category.
-     * If not passed, the default is the root category.
+     * Parent category ID.
+     *
+     * Default: root category ID
      */
     _id?: string | null;
     /**
-     * Represents the index of current category within the parent category.
+     * Index position of the category within the parent category.
      * @readonly
      */
     index?: number | null;
@@ -3879,12 +4062,12 @@ interface TextNodeStyle {
 }
 interface TreeReference {
     /**
-     * The unique namespace of an app in dev-center that owns this tree.
-     * Should meet the format of @company/app1 where @company is an organizational unit and app1 is the app name.
-     * For example: @bookings/bookingslist, @achievements/quizzes
+     * Namespace of the app that manages the tree.
+     *
+     * For example, `"@wix/stores"`, `"@bookings/bookingslist"`, `"@achievements/quizzes"`.
      */
     appNamespace?: string;
-    /** Optional - The key of the tree. Must be provided when single app manages more than one tree. */
+    /** Tree key. You must pass this when a single app manages more than one tree. */
     treeKey?: string | null;
 }
 interface ExtendedFields {
@@ -3898,54 +4081,139 @@ interface ExtendedFields {
      */
     namespaces?: Record<string, Record<string, any>>;
 }
+interface ItemReference {
+    /**
+     * ID of the item within the catalog it belongs to.
+     *
+     * For example, `product.id` for Wix Stores or `event.id` for Wix Events.
+     */
+    catalogItemId?: string;
+    /**
+     * ID of the app providing the catalog.
+     *
+     * You can get your app's ID from its page in the [Wix Dev Center](https://dev.wix.com/apps).
+     *
+     * For items from Wix catalogs, the following values always apply:
+     * + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
+     * + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
+     * + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
+     */
+    appId?: string;
+}
 interface CreateCategoryRequest {
-    /** Category to be created. */
+    /** Category to create. */
     category: Category;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields[];
 }
 declare enum SingleEntityOpsRequestedFields {
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
-    BREADCRUMBS = "BREADCRUMBS"
+    BREADCRUMBS = "BREADCRUMBS",
+    DESCRIPTION = "DESCRIPTION",
+    RICH_CONTENT_DESCRIPTION = "RICH_CONTENT_DESCRIPTION"
 }
 interface CreateCategoryResponse {
-    /** The created Category. */
+    /** Created category. */
     category?: Category;
 }
 interface GetCategoryRequest {
-    /** Id of the Category to retrieve. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields[];
 }
 interface GetCategoryResponse {
-    /** The retrieved Category. */
+    /** Category. */
     category?: Category;
 }
 interface UpdateCategoryRequest {
-    /** Category to be updated, may be partial. */
+    /** Category to update. */
     category: Category;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields[];
 }
 interface UpdateCategoryResponse {
-    /** The updated Category. */
+    /** Updated category. */
     category?: Category;
 }
 interface DeleteCategoryRequest {
-    /** Id of the Category to delete. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface DeleteCategoryResponse {
 }
+interface QueryCategoriesRequest {
+    /** Query options. */
+    query?: CursorQuery;
+    /** Category tree reference details. */
+    treeReference: TreeReference;
+    /**
+     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
+     * Used only in the first request. Following requests use the cursor token.
+     */
+    returnNonVisibleCategories?: boolean;
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
+    fields?: RequestedFields[];
+}
+interface CursorQuery extends CursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+    /**
+     * Filter object in the following format:
+     * `"filter" : {
+     * "fieldName1": "value1",
+     * "fieldName2":{"$operator":"value2"}
+     * }`
+     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the following format:
+     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     */
+    sort?: Sorting[];
+}
+/** @oneof */
+interface CursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+}
 interface Sorting {
     /** Name of the field to sort by. */
     fieldName?: string;
@@ -3971,20 +4239,46 @@ declare enum RequestedFields {
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     BREADCRUMBS = "BREADCRUMBS"
 }
+interface QueryCategoriesResponse {
+    /** Categories which satisfy the provided query. */
+    categories?: Category[];
+    /** Paging metadata. Contains cursor which can be used in next query. */
+    pagingMetadata?: PlatformPagingMetadataV2;
+}
+interface PlatformPagingMetadataV2 {
+    /** The number of items returned in this response. */
+    count?: number | null;
+    /** Cursors to navigate through result pages. Returned if cursor paging was used. */
+    cursors?: CommonCursors;
+}
+interface CommonCursors {
+    /** Cursor string pointing to the next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to the previous page in the list of results. */
+    prev?: string | null;
+}
 interface SearchCategoriesRequest {
-    /** WQL query expression. */
+    /** Search options. */
     search?: CursorSearch;
     /**
-     * A reference to the tree that contains this category.
-     * Used only in the first request. Following requests use the cursor token.
+     * Category tree reference details.
+     * > **Note:** Pass `treeReference` only in the first request. Pass the cursor token in subsequent requests.
      */
     treeReference: TreeReference;
     /**
-     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
-     * Used only in the first request. Following requests use the cursor token.
+     * Whether to return the categories with `visible: false`.
+     *
+     * Default: `false` - only visible categories are returned in the response
      */
     returnNonVisibleCategories?: boolean;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: RequestedFields[];
 }
 interface CursorSearch extends CursorSearchPagingMethodOneOf {
@@ -4195,13 +4489,23 @@ interface NestedAggregation {
     nestedAggregations?: NestedAggregationItem[];
 }
 interface SearchDetails {
-    /** Defines how separate search terms in `expression` are combined */
+    /**
+     * Defines how separate search terms in `expression` are combined.
+     *
+     * Supported values:
+     * + `OR` - Any of the search terms must be present
+     * + `AND` - All search terms must be present
+     */
     mode?: Mode;
-    /** Search term or expression */
+    /** Search term or expression. */
     expression?: string | null;
-    /** Fields to search in. If empty - will search in all searchable fields. Use dot notation to specify json path */
+    /**
+     * Fields in which to search for the `expression`. Use dot notation to specify field path.
+     *
+     * When empty - all searchable fields are looked at.
+     */
     fields?: string[];
-    /** Flag if should use auto fuzzy search (allowing typos by a managed proximity algorithm) */
+    /** Whether to use fuzzy search - allowing typos and other minor errors in the search. */
     fuzzy?: boolean;
 }
 declare enum Mode {
@@ -4211,9 +4515,9 @@ declare enum Mode {
     AND = "AND"
 }
 interface SearchCategoriesResponse {
-    /** Categories which satisfy the provided query. */
+    /** List of categories. */
     categories?: Category[];
-    /** Paging metadata. Contains cursor which can be used in next query. */
+    /** Paging metadata. */
     pagingMetadata?: CursorPagingMetadata;
     /** Aggregation data. */
     aggregationData?: AggregationData;
@@ -4400,63 +4704,68 @@ interface AggregationResultsResultOneOf {
 }
 interface CountCategoriesRequest {
     /**
-     * A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
-     * To understand supported filters and limitations see `SearchCategories` method.
+     * Filter object.
+     *
+     * Learn more about the [filter object structure](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
-    /** free text to match in searchable fields */
+    /** Search options. */
     search?: SearchDetails;
-    /**
-     * A reference to the tree that contains this category.
-     * Used only in the first request. Following requests use the cursor token.
-     */
+    /** Category tree reference details. */
     treeReference: TreeReference;
     /**
-     * Whether to return categories with `visible:false`. Default: false so only visible categories will be in response.
-     * Used only in the first request. Following requests use the cursor token.
+     * Whether to return categories with `visible: false` (hidden categories).
+     *
+     * Default: `false` - only visible categories are returned in the response
      */
     returnNonVisibleCategories?: boolean;
 }
 interface CountCategoriesResponse {
-    /** Total count of categories which satisfy the provided request. */
+    /** Total count of categories which satisfy the given filter and/or search. */
     count?: number;
 }
 interface MoveCategoryRequest {
-    /** ID of category to place. */
+    /** ID of the category to move. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
     /**
-     * ID of parent category.
-     * Optional. When not passed it will fallback to the root category
+     * Parent category ID.
+     *
+     * Default: root category ID
      */
     parentCategoryId?: string | null;
     /**
      * Where to place the subcategory.
-     * `FIRST` - make category with `category_id` first subcategory with manual arrangement.
-     * `LAST` - make category with `category_id` last subcategory with manual arrangement.
-     * `BEFORE` - requires `move_before_category_id`, category with `category_id` will be moved before it.
+     *
+     * + `FIRST`: Position the category as the first subcategory.
+     * + `LAST`: Position the category as the last subcategory.
+     * + `AFTER`: Position the category after the category ID passed in `moveAfterCategoryId`.
      */
     position: Position;
-    /** Required when `position` is `BEFORE`. Otherwise ignored */
-    moveBeforeCategoryId?: string | null;
+    /** Required when passing `position: AFTER`. */
+    moveAfterCategoryId?: string | null;
 }
 declare enum Position {
     UNKNOWN_POSITION = "UNKNOWN_POSITION",
     FIRST = "FIRST",
     LAST = "LAST",
-    BEFORE = "BEFORE"
+    AFTER = "AFTER"
 }
 interface MoveCategoryResponse {
-    /** ID of parent category. */
+    /** Parent category ID. */
     parentCategoryId?: string | null;
-    /** Information about manually arranged categories after move. */
+    /** List of category IDs in the new order of arrangement. */
     categoriesAfterMove?: string[];
 }
 interface BulkCategoriesResult {
-    /** Information about successful action or error for failure. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemMetadata;
-    /** Created or updated category. Optional - returned only if requested with `return_entity` set to `true`. */
+    /**
+     * Full category entity.
+     *
+     * Returned only if `returnEntity: true` is passed in the request.
+     */
     category?: Category;
 }
 interface ItemMetadata {
@@ -4486,17 +4795,28 @@ interface BulkActionMetadata {
     undetailedFailures?: number;
 }
 interface BulkUpdateCategoriesRequest {
-    /** List of categories to be updated. */
+    /** List of categories to update. */
     categories: MaskedCategory[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Whether to return the category entity in the response. */
+    /**
+     * Whether to return the full category entity in the response.
+     *
+     * Default: `false`
+     */
     returnEntity?: boolean;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: RequestedFields[];
 }
 interface MaskedCategory {
-    /** Category to be updated, may be partial. */
+    /** Category to update. */
     category?: Category;
 }
 interface BulkUpdateCategoriesResponse {
@@ -4506,61 +4826,73 @@ interface BulkUpdateCategoriesResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface UpdateCategoryVisibilityRequest {
-    /** ID of category to be updated */
+    /** Category ID. */
     categoryId: string;
-    /** value to set `visible` to */
+    /**
+     * Whether the category is visible to site visitors in dynamic pages.
+     *
+     * + If a parent category's visibility is set to `false`, all the children categories' visibility will also be set to `false`.
+     * + Passing `true` will fail if the visibility of any parent categories is `false`.
+     */
     visible: boolean;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Latest revision of the category. */
+    /**
+     * Latest revision of the category.
+     * To prevent conflicting changes, the current revision must be passed on update.
+     */
     revision: string | null;
-    /** Fields to return in the response. When not provided, these fields are not returned. */
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values:
+     * + `BREADCRUMBS`
+     * + `DESCRIPTION`
+     * + `RICH_CONTENT_DESCRIPTION`
+     */
     fields?: SingleEntityOpsRequestedFields[];
 }
 interface UpdateCategoryVisibilityResponse {
-    /** The updated Category. */
+    /** Updated category. */
     category?: Category;
 }
 interface BulkAddItemsToCategoryRequest {
-    /** Category id. */
+    /** Category ID. */
     categoryId: string;
-    /** List of catalog items with reference info. */
+    /** List of items to add. */
     items: ItemReference[];
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
-interface ItemReference {
-    /** ID of the item within its Wix or 3rd-party catalog. For example, `productId` for Wix Stores or `eventId` for Wix Events. */
-    catalogItemId?: string;
-    /** ID of the catalog app. For example, the Wix Stores `appId`, or the 3rd-party `appId`. */
-    appId?: string;
-}
 interface BulkAddItemsToCategoryResponse {
-    /** Items added by bulk action. */
+    /** List of items added to a category by bulk action. */
     results?: BulkItemsToCategoryResult[];
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkItemsToCategoryResult {
-    /** Information about items that were added successfully and errors for failed items. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemReferenceMetadata;
 }
 interface ItemReferenceMetadata {
-    /** Item reference from request. */
+    /** Catalog and item reference info. */
     item?: ItemReference;
-    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    /** Original 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. */
+    /**
+     * Whether the action was successful.
+     * When `false`, the `error` field is populated.
+     */
     success?: boolean;
-    /** Details about the error in case of failure. */
+    /** Error details in the case of an unsuccessful action. */
     error?: ApplicationError;
 }
 interface BulkAddItemToCategoriesRequest {
-    /** Catalog item reference info */
+    /** Item to add. */
     item: ItemReference;
-    /** Category ids. */
+    /** IDs of categories to which to add the item. */
     categoryIds: string[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface BulkAddItemToCategoriesResponse {
@@ -4570,15 +4902,15 @@ interface BulkAddItemToCategoriesResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkItemToCategoriesResult {
-    /** Information about categories to which item was added successfully and errors for failed items. `id` is ID of category. */
+    /** Bulk action metadata for category. */
     itemMetadata?: ItemMetadata;
 }
 interface BulkRemoveItemsFromCategoryRequest {
-    /** Category id */
+    /** Category ID. */
     categoryId: string;
-    /** List of catalog items with reference info. */
+    /** List of items to remove. */
     items: ItemReference[];
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface BulkRemoveItemsFromCategoryResponse {
@@ -4588,11 +4920,11 @@ interface BulkRemoveItemsFromCategoryResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkRemoveItemFromCategoriesRequest {
-    /** Catalog item reference info */
+    /** Item to remove. */
     item: ItemReference;
-    /** Category ids. */
+    /** IDs of categories from which to remove the item. */
     categoryIds: string[];
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface BulkRemoveItemFromCategoriesResponse {
@@ -4602,26 +4934,42 @@ interface BulkRemoveItemFromCategoriesResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface ListItemsInCategoryRequest extends ListItemsInCategoryRequestPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `use_category_arrangement` or `include_items_from_subcategories`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
-    /** ID of category containing items. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /** Default: `false`. When `true` items arranged by user will be return before all other items. */
+    /**
+     * Whether to use category arrangement for sorting items.
+     *
+     * Default: `false`
+     */
     useCategoryArrangement?: boolean;
-    /** Default: `false`. When `false` only direct items of category will be returned. When `true` response contains also items from all subcategories which current category contains */
+    /**
+     * Whether to include items from subcategories.
+     *
+     * Default: `false` (only direct items of the category will be returned)
+     */
     includeItemsFromSubcategories?: boolean;
 }
 /** @oneof */
 interface ListItemsInCategoryRequestPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `use_category_arrangement` or `include_items_from_subcategories`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
 }
 interface ListItemsInCategoryResponse {
-    /** Items which satisfy query. */
+    /** List of items in the category. */
     items?: ItemReference[];
-    /** Paging metadata. Contains cursor which can be used in next query. */
+    /** Paging metadata. */
     pagingMetadata?: PagingMetadataV2;
 }
 interface PagingMetadataV2 {
@@ -4635,46 +4983,43 @@ interface PagingMetadataV2 {
     cursors?: Cursors;
 }
 interface ListCategoriesForItemRequest {
-    /** Catalog item reference info. */
+    /** Item reference info. */
     item: ItemReference;
-    /** A reference to the tree that contains the categories. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface ListCategoriesForItemResponse {
-    /** A list of category IDs that contain this item directly. */
+    /** List of IDs of categories that directly contain this item. */
     directCategoryIds?: string[];
-    /** A list of category IDs that contain this item directly and their parent category IDs. */
+    /** List of IDs of categories that directly contain this item, and their parent category IDs. */
     allCategoryIds?: string[];
 }
 interface ListTreesRequest {
 }
 interface ListTreesResponse {
-    /** A list of all trees */
+    /** List of trees. */
     trees?: TreeReference[];
 }
 interface SetArrangedItemsRequest {
-    /** ID of category. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
-    /**
-     * List of arranged items to set.
-     * All items must be direct children of category with `category_id`, otherwise error returned.
-     */
+    /** List of items to set. */
     items?: ItemReference[];
 }
 interface SetArrangedItemsResponse {
-    /** The updated list of arranged items in category. */
+    /** List of arranged items. */
     items?: ItemReference[];
 }
 interface GetArrangedItemsRequest {
-    /** ID of category. */
+    /** Category ID. */
     categoryId: string;
-    /** A reference to the tree that contains this category. */
+    /** Category tree reference details. */
     treeReference: TreeReference;
 }
 interface GetArrangedItemsResponse {
-    /** List of arranged items in category. */
+    /** List of arranged items. */
     items?: ItemReference[];
 }
 interface BreadcrumbItemNonNullableFields {
@@ -4967,6 +5312,9 @@ interface GetCategoryResponseNonNullableFields {
 interface UpdateCategoryResponseNonNullableFields {
     category?: CategoryNonNullableFields;
 }
+interface QueryCategoriesResponseNonNullableFields {
+    categories: CategoryNonNullableFields[];
+}
 interface ValueAggregationResultNonNullableFields {
     value: string;
     count: number;
@@ -5123,6 +5471,7 @@ declare function updateCategory(): __PublicMethodMetaInfo<'PATCH', {
 declare function deleteCategory(): __PublicMethodMetaInfo<'DELETE', {
     categoryId: string;
 }, DeleteCategoryRequest, DeleteCategoryRequest$1, DeleteCategoryResponse, DeleteCategoryResponse$1>;
+declare function queryCategories(): __PublicMethodMetaInfo<'POST', {}, QueryCategoriesRequest, QueryCategoriesRequest$1, QueryCategoriesResponse & QueryCategoriesResponseNonNullableFields, QueryCategoriesResponse$1 & QueryCategoriesResponseNonNullableFields$1>;
 declare function searchCategories(): __PublicMethodMetaInfo<'POST', {}, SearchCategoriesRequest, SearchCategoriesRequest$1, SearchCategoriesResponse & SearchCategoriesResponseNonNullableFields, SearchCategoriesResponse$1 & SearchCategoriesResponseNonNullableFields$1>;
 declare function countCategories(): __PublicMethodMetaInfo<'POST', {}, CountCategoriesRequest, CountCategoriesRequest$1, CountCategoriesResponse & CountCategoriesResponseNonNullableFields, CountCategoriesResponse$1 & CountCategoriesResponseNonNullableFields$1>;
 declare function moveCategory(): __PublicMethodMetaInfo<'POST', {
@@ -5165,12 +5514,13 @@ declare const meta_listCategoriesForItem: typeof listCategoriesForItem;
 declare const meta_listItemsInCategory: typeof listItemsInCategory;
 declare const meta_listTrees: typeof listTrees;
 declare const meta_moveCategory: typeof moveCategory;
+declare const meta_queryCategories: typeof queryCategories;
 declare const meta_searchCategories: typeof searchCategories;
 declare const meta_setArrangedItems: typeof setArrangedItems;
 declare const meta_updateCategory: typeof updateCategory;
 declare const meta_updateCategoryVisibility: typeof updateCategoryVisibility;
 declare namespace meta {
-  export { type meta___PublicMethodMetaInfo as __PublicMethodMetaInfo, meta_bulkAddItemToCategories as bulkAddItemToCategories, meta_bulkAddItemsToCategory as bulkAddItemsToCategory, meta_bulkRemoveItemFromCategories as bulkRemoveItemFromCategories, meta_bulkRemoveItemsFromCategory as bulkRemoveItemsFromCategory, meta_bulkUpdateCategories as bulkUpdateCategories, meta_countCategories as countCategories, meta_createCategory as createCategory, meta_deleteCategory as deleteCategory, meta_getArrangedItems as getArrangedItems, meta_getCategory as getCategory, meta_listCategoriesForItem as listCategoriesForItem, meta_listItemsInCategory as listItemsInCategory, meta_listTrees as listTrees, meta_moveCategory as moveCategory, meta_searchCategories as searchCategories, meta_setArrangedItems as setArrangedItems, meta_updateCategory as updateCategory, meta_updateCategoryVisibility as updateCategoryVisibility };
+  export { type meta___PublicMethodMetaInfo as __PublicMethodMetaInfo, meta_bulkAddItemToCategories as bulkAddItemToCategories, meta_bulkAddItemsToCategory as bulkAddItemsToCategory, meta_bulkRemoveItemFromCategories as bulkRemoveItemFromCategories, meta_bulkRemoveItemsFromCategory as bulkRemoveItemsFromCategory, meta_bulkUpdateCategories as bulkUpdateCategories, meta_countCategories as countCategories, meta_createCategory as createCategory, meta_deleteCategory as deleteCategory, meta_getArrangedItems as getArrangedItems, meta_getCategory as getCategory, meta_listCategoriesForItem as listCategoriesForItem, meta_listItemsInCategory as listItemsInCategory, meta_listTrees as listTrees, meta_moveCategory as moveCategory, meta_queryCategories as queryCategories, meta_searchCategories as searchCategories, meta_setArrangedItems as setArrangedItems, meta_updateCategory as updateCategory, meta_updateCategoryVisibility as updateCategoryVisibility };
 }
 
 export { meta as categories };