@wix/calendar 1.0.35 → 1.0.37

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

@@ -327,36 +327,42 @@ declare enum Transparency$1 {
 }
 interface Location$3 {
     /**
-     * The location ID. Optional.
-     * Currently only supported for locations of type `BUSINESS`, and used to reference the Wix Business Location.
+     * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * ID. Available only for `BUSINESS` locations.
      */
     id?: string | null;
     /**
-     * The location type.
-     * The possible values are:
-     * - `"BUSINESS"` event takes place at the business location.
-     * - `"CUSTOMER"` event takes place at the customer location.
-     * - `"CUSTOM"` event takes place at the custom location.
+     * Location type.
+     *
+     * Supported values:
+     * + `BUSINESS`: The event is held at a business location.
+     * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
+     * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
      */
     type?: LocationType$3;
     /**
-     * The location name. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location name. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * `name`.
+     *
+     * Min: 1 character
+     * Max: 150 characters
      */
     name?: string | null;
     /**
-     * The location address. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location address. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
+     * `formattedAddress`.
      */
     address?: string | null;
 }
 declare enum LocationType$3 {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** The event takes place at the business location. */
+    /** The event is held at a business location. */
     BUSINESS = "BUSINESS",
-    /** The event takes place at the customer location. */
+    /** The event is held at the customer's location, such as their home or office. */
     CUSTOMER = "CUSTOMER",
-    /** The event takes place at the custom location. */
+    /** The event is held at an address or venue not tied to the business or customer. */
     CUSTOM = "CUSTOM"
 }
 interface Resource$1 {
@@ -391,9 +397,9 @@ interface Resource$1 {
 }
 declare enum Role$3 {
     UNKNOWN_ROLE = "UNKNOWN_ROLE",
-    /** Role grants full write and read access. */
+    /** Full read and write access. */
     WRITER = "WRITER",
-    /** Role grants full read access and permission to edit notes. */
+    /** Full read access, write access limited to `event.notes`. */
     COMMENTER = "COMMENTER"
 }
 interface Participants$1 {
@@ -451,15 +457,35 @@ declare enum ParticipantsStatus$1 {
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
 }
 interface ConferencingDetails$3 {
-    /** World known conference type, such as Zoom. */
+    /** Conference type. For example, `Zoom`. */
     type?: Type$3;
-    /** URL used by the host to start the conference. */
+    /**
+     * URL used by the host to start the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     hostUrl?: string | null;
-    /** URL used by a guest to join the conference. */
+    /**
+     * URL used by a guest to join the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     guestUrl?: string | null;
-    /** Optional conference password. */
+    /**
+     * Conference password.
+     *
+     * Min: 1 character
+     * Max: 100 characters
+     */
     password?: string | null;
-    /** Optional conference ID in an external system. */
+    /**
+     * Conference ID in an external system.
+     *
+     * Min: 1 character
+     * Max: 150 characters
+     */
     externalId?: string | null;
 }
 declare enum Type$3 {
@@ -487,14 +513,17 @@ declare enum Field$1 {
     CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
 }
 interface Permission$3 {
-    /** The identity granted the permission. */
+    /**
+     * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
+     * granted the permission.
+     */
     identity?: CommonIdentificationData$3;
     /**
-     * The permission role.
+     * Permission role.
      *
-     * The possible values are:
-     * - `"WRITER"` Role grants full write and read access.
-     * - `"COMMENTER"` Role grants full read access and permission to edit notes.
+     * Supported values:
+     * + `WRITER`: Full read and write access.
+     * + `COMMENTER`: Full read access, write access limited to `event.notes`.
      */
     role?: Role$3;
 }
@@ -577,6 +606,13 @@ interface ListEventsRequest$1 {
      * Min: 100 event IDs
      */
     eventIds: string[];
+    /**
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     */
     timeZone?: string | null;
     /**
      * Information about which fields containing personal data to return. Refer to the
@@ -831,11 +867,17 @@ interface UpdateEventRequest$1 {
 }
 interface ParticipantNotification$3 {
     /**
-     * Whether to notify the participant/s about changes made to the schedule or event.
-     * Default is false.
+     * Whether to notify the participants about changes made to the schedule or event.
+     *
+     * Default: `false`
      */
     notifyParticipants?: boolean | null;
-    /** Optional custom message to send. */
+    /**
+     * Message to send.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     message?: string | null;
 }
 interface UpdateEventResponse$1 {
@@ -989,33 +1031,43 @@ interface BulkCancelEventResponse$1 {
 }
 interface ListEventsByContactIdRequest$1 {
     /**
-     * The ID of the contact participating in the events.
-     * Required, unless `cursorPaging` is provided.
+     * ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * to retrieve events for. Required, unless you provide `cursorPaging`.
      */
     contactId: string | null;
     /**
-     * Local start date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-01T00:00:00`.
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Required, unless `cursorPaging` is provided.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate`.
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-7T00:00:00`.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`. Can't be more than a full year after
+     * `fromLocalDate`.
      *
-     * Required, unless `cursorPaging` is provided.
-     * Max: 1 year after `fromLocalDate`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate`.
      */
     toLocalDate?: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional Wix app ID to filter events by. */
+    /**
+     * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * to filter events by.
+     */
     appId?: string | null;
-    /** Optional cursor to the next events page. */
+    /** Cursor to retrieve the next page of the results. */
     cursorPaging?: CommonCursorPaging$1;
 }
 /** TODO Diverge */
@@ -1035,7 +1087,7 @@ interface CommonCursorPaging$1 {
     cursor?: string | null;
 }
 interface ListEventsByContactIdResponse$1 {
-    /** The participant events. */
+    /** Retrieved events. */
     events?: Event$1[];
     /** Paging metadata. */
     pagingMetadata?: CommonCursorPagingMetadata$1;
@@ -1059,46 +1111,58 @@ interface CommonCursors$1 {
 }
 interface ListEventsByMemberIdRequest$1 {
     /**
-     * The ID of the member participating in the events.
-     *
-     * Can be `me` for the currently logged-in member ID.
-     * To retrieve other member events the `CALENDAR.EVENT_READ_PI` permission is required.
-     *
-     * Required, unless `cursorPaging` is provided.
+     * ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
+     * to retrieve events for. Required, unless you provide `cursorPaging`.
+     * Provide `me` to retrieve events for the currently logged-in member.
+     * You must have the `Read Calendars - Including PI`
+     * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
+     * to retrieve events for members who aren't the currently logged in member.
      */
     memberId: string | null;
     /**
-     * Local start date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-01T00:00:00`.
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Required, unless `cursorPaging` or `eventIds` are provided.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate`.
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-7T00:00:00`.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`. Can't be more than a full year after
+     * `fromLocalDate`.
      *
-     * Required, unless `cursorPaging` or `eventIds` are provided.
-     * Max: 1 year after `fromLocalDate`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate`.
      */
     toLocalDate?: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional Wix app ID to filter events by. */
+    /**
+     * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * to filter events by.
+     */
     appId?: string | null;
-    /** Optional cursor to the next events page. */
+    /** Cursor to retrieve the next page of the results. */
     cursorPaging?: CommonCursorPaging$1;
     /**
-     * Optional event IDs to filter events by.
-     * If provided, other filters are ignored.
+     * IDs of the events to retrieve.
+     * If you provide a list of IDs, all other filters are ignored.
+     *
+     * Max: 100 `eventId`s
      */
     eventIds?: string[];
 }
 interface ListEventsByMemberIdResponse$1 {
-    /** The participant events. */
+    /** Retrieved events. */
     events?: Event$1[];
     /** Paging metadata. */
     pagingMetadata?: CommonCursorPagingMetadata$1;
@@ -1530,36 +1594,42 @@ declare enum Transparency {
 }
 interface Location$2 {
     /**
-     * The location ID. Optional.
-     * Currently only supported for locations of type `BUSINESS`, and used to reference the Wix Business Location.
+     * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * ID. Available only for `BUSINESS` locations.
      */
     _id?: string | null;
     /**
-     * The location type.
-     * The possible values are:
-     * - `"BUSINESS"` event takes place at the business location.
-     * - `"CUSTOMER"` event takes place at the customer location.
-     * - `"CUSTOM"` event takes place at the custom location.
+     * Location type.
+     *
+     * Supported values:
+     * + `BUSINESS`: The event is held at a business location.
+     * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
+     * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
      */
     type?: LocationType$2;
     /**
-     * The location name. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location name. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * `name`.
+     *
+     * Min: 1 character
+     * Max: 150 characters
      */
     name?: string | null;
     /**
-     * The location address. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location address. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
+     * `formattedAddress`.
      */
     address?: string | null;
 }
 declare enum LocationType$2 {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** The event takes place at the business location. */
+    /** The event is held at a business location. */
     BUSINESS = "BUSINESS",
-    /** The event takes place at the customer location. */
+    /** The event is held at the customer's location, such as their home or office. */
     CUSTOMER = "CUSTOMER",
-    /** The event takes place at the custom location. */
+    /** The event is held at an address or venue not tied to the business or customer. */
     CUSTOM = "CUSTOM"
 }
 interface Resource {
@@ -1594,9 +1664,9 @@ interface Resource {
 }
 declare enum Role$2 {
     UNKNOWN_ROLE = "UNKNOWN_ROLE",
-    /** Role grants full write and read access. */
+    /** Full read and write access. */
     WRITER = "WRITER",
-    /** Role grants full read access and permission to edit notes. */
+    /** Full read access, write access limited to `event.notes`. */
     COMMENTER = "COMMENTER"
 }
 interface Participants {
@@ -1654,15 +1724,35 @@ declare enum ParticipantsStatus {
     PENDING_CONFIRMATION = "PENDING_CONFIRMATION"
 }
 interface ConferencingDetails$2 {
-    /** World known conference type, such as Zoom. */
+    /** Conference type. For example, `Zoom`. */
     type?: Type$2;
-    /** URL used by the host to start the conference. */
+    /**
+     * URL used by the host to start the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     hostUrl?: string | null;
-    /** URL used by a guest to join the conference. */
+    /**
+     * URL used by a guest to join the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     guestUrl?: string | null;
-    /** Optional conference password. */
+    /**
+     * Conference password.
+     *
+     * Min: 1 character
+     * Max: 100 characters
+     */
     password?: string | null;
-    /** Optional conference ID in an external system. */
+    /**
+     * Conference ID in an external system.
+     *
+     * Min: 1 character
+     * Max: 150 characters
+     */
     externalId?: string | null;
 }
 declare enum Type$2 {
@@ -1690,14 +1780,17 @@ declare enum Field {
     CONFERENCING_DETAILS = "CONFERENCING_DETAILS"
 }
 interface Permission$2 {
-    /** The identity granted the permission. */
+    /**
+     * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
+     * granted the permission.
+     */
     identity?: CommonIdentificationData$2;
     /**
-     * The permission role.
+     * Permission role.
      *
-     * The possible values are:
-     * - `"WRITER"` Role grants full write and read access.
-     * - `"COMMENTER"` Role grants full read access and permission to edit notes.
+     * Supported values:
+     * + `WRITER`: Full read and write access.
+     * + `COMMENTER`: Full read access, write access limited to `event.notes`.
      */
     role?: Role$2;
 }
@@ -1780,6 +1873,13 @@ interface ListEventsRequest {
      * Min: 100 event IDs
      */
     eventIds: string[];
+    /**
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for calculating `adjustedStart` and `adjustedEnd`. For example,
+     * `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     */
     timeZone?: string | null;
     /**
      * Information about which fields containing personal data to return. Refer to the
@@ -2034,11 +2134,17 @@ interface UpdateEventRequest {
 }
 interface ParticipantNotification$2 {
     /**
-     * Whether to notify the participant/s about changes made to the schedule or event.
-     * Default is false.
+     * Whether to notify the participants about changes made to the schedule or event.
+     *
+     * Default: `false`
      */
     notifyParticipants?: boolean | null;
-    /** Optional custom message to send. */
+    /**
+     * Message to send.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     message?: string | null;
 }
 interface UpdateEventResponse {
@@ -2192,33 +2298,43 @@ interface BulkCancelEventResponse {
 }
 interface ListEventsByContactIdRequest {
     /**
-     * The ID of the contact participating in the events.
-     * Required, unless `cursorPaging` is provided.
+     * ID of the [contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * to retrieve events for. Required, unless you provide `cursorPaging`.
      */
     contactId: string | null;
     /**
-     * Local start date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-01T00:00:00`.
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Required, unless `cursorPaging` is provided.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate`.
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-7T00:00:00`.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`. Can't be more than a full year after
+     * `fromLocalDate`.
      *
-     * Required, unless `cursorPaging` is provided.
-     * Max: 1 year after `fromLocalDate`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate`.
      */
     toLocalDate?: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional Wix app ID to filter events by. */
+    /**
+     * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * to filter events by.
+     */
     appId?: string | null;
-    /** Optional cursor to the next events page. */
+    /** Cursor to retrieve the next page of the results. */
     cursorPaging?: CommonCursorPaging;
 }
 /** TODO Diverge */
@@ -2238,7 +2354,7 @@ interface CommonCursorPaging {
     cursor?: string | null;
 }
 interface ListEventsByContactIdResponse {
-    /** The participant events. */
+    /** Retrieved events. */
     events?: Event[];
     /** Paging metadata. */
     pagingMetadata?: CommonCursorPagingMetadata;
@@ -2262,46 +2378,58 @@ interface CommonCursors {
 }
 interface ListEventsByMemberIdRequest {
     /**
-     * The ID of the member participating in the events.
-     *
-     * Can be `me` for the currently logged-in member ID.
-     * To retrieve other member events the `CALENDAR.EVENT_READ_PI` permission is required.
-     *
-     * Required, unless `cursorPaging` is provided.
+     * ID of the [member](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/member-object)
+     * to retrieve events for. Required, unless you provide `cursorPaging`.
+     * Provide `me` to retrieve events for the currently logged-in member.
+     * You must have the `Read Calendars - Including PI`
+     * [permission scope](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/configure-permissions-for-your-app)
+     * to retrieve events for members who aren't the currently logged in member.
      */
     memberId: string | null;
     /**
-     * Local start date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-01T00:00:00`.
+     * Local start date and time from which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`.
      *
-     * Required, unless `cursorPaging` or `eventIds` are provided.
+     * Events that start before the `fromLocalDate` but end after it are included in
+     * the results. Must be earlier than `toLocalDate`.
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which events are returned, in ISO-8601 format.
-     * E.g, `2024-01-7T00:00:00`.
+     * Local end date and time up to which events are returned in
+     * [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format. For example,
+     * `2024-01-30T13:30:00`. Can't be more than a full year after
+     * `fromLocalDate`.
      *
-     * Required, unless `cursorPaging` or `eventIds` are provided.
-     * Max: 1 year after `fromLocalDate`.
+     * Events that start before `toLocalDate` but end after it are included in the
+     * results. Must be later than `fromLocalDate`.
      */
     toLocalDate?: string | null;
     /**
-     * The time zone, in IANA time zone format.
-     * Default is the Wix Business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database)
+     * for `fromLocalDate`, `toLocalDate`, and for calculating `adjustedStart` and
+     * `adjustedEnd`. For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
      */
     timeZone?: string | null;
-    /** Optional Wix app ID to filter events by. */
+    /**
+     * [App ID](https://dev.wix.com/docs/rest/articles/getting-started/wix-business-solutions)
+     * to filter events by.
+     */
     appId?: string | null;
-    /** Optional cursor to the next events page. */
+    /** Cursor to retrieve the next page of the results. */
     cursorPaging?: CommonCursorPaging;
     /**
-     * Optional event IDs to filter events by.
-     * If provided, other filters are ignored.
+     * IDs of the events to retrieve.
+     * If you provide a list of IDs, all other filters are ignored.
+     *
+     * Max: 100 `eventId`s
      */
     eventIds?: string[];
 }
 interface ListEventsByMemberIdResponse {
-    /** The participant events. */
+    /** Retrieved events. */
     events?: Event[];
     /** Paging metadata. */
     pagingMetadata?: CommonCursorPagingMetadata;
@@ -2480,7 +2608,7 @@ interface EventsView$1 {
 interface GetEventsViewRequest$1 {
 }
 interface GetEventsViewResponse$1 {
-    /** The events view. */
+    /** Retrieved event view. */
     eventsView?: EventsView$1;
 }
 
@@ -2505,7 +2633,7 @@ interface EventsView {
 interface GetEventsViewRequest {
 }
 interface GetEventsViewResponse {
-    /** The events view. */
+    /** Retrieved event view. */
     eventsView?: EventsView;
 }
 
@@ -2541,7 +2669,7 @@ interface Participation$1 extends ParticipationParticipatedItemOneOf$1 {
     scheduleId?: string | null;
     /**
      * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
-     * associated with the participantion.
+     * associated with the participation.
      */
     eventId?: string | null;
     /**
@@ -2572,7 +2700,7 @@ interface Participation$1 extends ParticipationParticipatedItemOneOf$1 {
      */
     status?: Status$5;
     /**
-     * ID of the app that owns the particpation `object`. Identical to `appId` of the
+     * ID of the app that owns the participation `object`. Identical to `appId` of the
      * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
      * that the related
      * [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
@@ -2588,12 +2716,12 @@ interface Participation$1 extends ParticipationParticipatedItemOneOf$1 {
      */
     revision?: string | null;
     /**
-     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
+     * Date the participation was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     createdDate?: Date | null;
     /**
-     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
+     * Date the participation was updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     updatedDate?: Date | null;
@@ -2609,18 +2737,26 @@ interface ParticipationParticipatedItemOneOf$1 {
     scheduleId?: string | null;
     /**
      * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
-     * associated with the participantion.
+     * associated with the participation.
      */
     eventId?: string | null;
 }
 interface Participant$1 {
-    /** The participant's name. */
+    /**
+     * Participant name.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     name?: string | null;
-    /** The participant's phone. */
+    /** Participant's phone number. */
     phone?: string | null;
-    /** The participant's email address. */
+    /** Participant's email address. */
     email?: string | null;
-    /** The ID of the Wix Contact. */
+    /**
+     * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * ID of the parcipant.
+     */
     contactId?: string | null;
 }
 declare enum Status$5 {
@@ -2712,7 +2848,7 @@ interface CreateParticipationRequest$1 {
     participation: Participation$1;
     /**
      * Idempotency key guaranteeing that you don't create the same `participation`
-     * oject more than once.
+     * object more than once.
      */
     idempotencyKey?: string | null;
 }
@@ -2765,7 +2901,7 @@ interface Participation extends ParticipationParticipatedItemOneOf {
     scheduleId?: string | null;
     /**
      * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
-     * associated with the participantion.
+     * associated with the participation.
      */
     eventId?: string | null;
     /**
@@ -2796,7 +2932,7 @@ interface Participation extends ParticipationParticipatedItemOneOf {
      */
     status?: Status$4;
     /**
-     * ID of the app that owns the particpation `object`. Identical to `appId` of the
+     * ID of the app that owns the participation `object`. Identical to `appId` of the
      * [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/schedule-object)
      * that the related
      * [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
@@ -2812,12 +2948,12 @@ interface Participation extends ParticipationParticipatedItemOneOf {
      */
     revision?: string | null;
     /**
-     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
+     * Date the participation was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date the event was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
+     * Date the participation was updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
      * @readonly
      */
     _updatedDate?: Date | null;
@@ -2833,18 +2969,26 @@ interface ParticipationParticipatedItemOneOf {
     scheduleId?: string | null;
     /**
      * ID of the [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/event-object)
-     * associated with the participantion.
+     * associated with the participation.
      */
     eventId?: string | null;
 }
 interface Participant {
-    /** The participant's name. */
+    /**
+     * Participant name.
+     *
+     * Min: 1 character
+     * Max: 200 characters
+     */
     name?: string | null;
-    /** The participant's phone. */
+    /** Participant's phone number. */
     phone?: string | null;
-    /** The participant's email address. */
+    /** Participant's email address. */
     email?: string | null;
-    /** The ID of the Wix Contact. */
+    /**
+     * [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/contact-v4/contact-object)
+     * ID of the parcipant.
+     */
     contactId?: string | null;
 }
 declare enum Status$4 {
@@ -2936,7 +3080,7 @@ interface CreateParticipationRequest {
     participation: Participation;
     /**
      * Idempotency key guaranteeing that you don't create the same `participation`
-     * oject more than once.
+     * object more than once.
      */
     idempotencyKey?: string | null;
 }
@@ -3040,7 +3184,7 @@ interface Schedule$1 {
      *
      * Supported values:
      * - `ACTIVE`: You can add events to the schedule or update its fields.
-     * - `CANCELLED` You can't add events to the schedule or update its fields.
+     * - `CANCELLED`: You can't add events to the schedule or update its fields.
      *
      * Default: `ACTIVE`
      * @readonly
@@ -3134,48 +3278,74 @@ declare enum Status$3 {
 }
 interface Location$1 {
     /**
-     * The location ID. Optional.
-     * Currently only supported for locations of type `BUSINESS`, and used to reference the Wix Business Location.
+     * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * ID. Available only for `BUSINESS` locations.
      */
     id?: string | null;
     /**
-     * The location type.
-     * The possible values are:
-     * - `"BUSINESS"` event takes place at the business location.
-     * - `"CUSTOMER"` event takes place at the customer location.
-     * - `"CUSTOM"` event takes place at the custom location.
+     * Location type.
+     *
+     * Supported values:
+     * + `BUSINESS`: The event is held at a business location.
+     * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
+     * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
      */
     type?: LocationType$1;
     /**
-     * The location name. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location name. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * `name`.
+     *
+     * Min: 1 character
+     * Max: 150 characters
      */
     name?: string | null;
     /**
-     * The location address. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location address. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
+     * `formattedAddress`.
      */
     address?: string | null;
 }
 declare enum LocationType$1 {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** The event takes place at the business location. */
+    /** The event is held at a business location. */
     BUSINESS = "BUSINESS",
-    /** The event takes place at the customer location. */
+    /** The event is held at the customer's location, such as their home or office. */
     CUSTOMER = "CUSTOMER",
-    /** The event takes place at the custom location. */
+    /** The event is held at an address or venue not tied to the business or customer. */
     CUSTOM = "CUSTOM"
 }
 interface ConferencingDetails$1 {
-    /** World known conference type, such as Zoom. */
+    /** Conference type. For example, `Zoom`. */
     type?: Type$1;
-    /** URL used by the host to start the conference. */
+    /**
+     * URL used by the host to start the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     hostUrl?: string | null;
-    /** URL used by a guest to join the conference. */
+    /**
+     * URL used by a guest to join the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     guestUrl?: string | null;
-    /** Optional conference password. */
+    /**
+     * Conference password.
+     *
+     * Min: 1 character
+     * Max: 100 characters
+     */
     password?: string | null;
-    /** Optional conference ID in an external system. */
+    /**
+     * Conference ID in an external system.
+     *
+     * Min: 1 character
+     * Max: 150 characters
+     */
     externalId?: string | null;
 }
 declare enum Type$1 {
@@ -3184,14 +3354,17 @@ declare enum Type$1 {
     CUSTOM = "CUSTOM"
 }
 interface Permission$1 {
-    /** The identity granted the permission. */
+    /**
+     * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
+     * granted the permission.
+     */
     identity?: CommonIdentificationData$1;
     /**
-     * The permission role.
+     * Permission role.
      *
-     * The possible values are:
-     * - `"WRITER"` Role grants full write and read access.
-     * - `"COMMENTER"` Role grants full read access and permission to edit notes.
+     * Supported values:
+     * + `WRITER`: Full read and write access.
+     * + `COMMENTER`: Full read access, write access limited to `event.notes`.
      */
     role?: Role$1;
 }
@@ -3216,9 +3389,9 @@ declare enum IdentityType$1 {
 }
 declare enum Role$1 {
     UNKNOWN_ROLE = "UNKNOWN_ROLE",
-    /** Role grants full write and read access. */
+    /** Full read and write access. */
     WRITER = "WRITER",
-    /** Role grants full read access and permission to edit notes. */
+    /** Full read access, write access limited to `event.notes`. */
     COMMENTER = "COMMENTER"
 }
 interface ExtendedFields$1 {
@@ -3365,11 +3538,17 @@ interface UpdateScheduleRequest$1 {
 }
 interface ParticipantNotification$1 {
     /**
-     * Whether to notify the participant/s about changes made to the schedule or event.
-     * Default is false.
+     * Whether to notify the participants about changes made to the schedule or event.
+     *
+     * Default: `false`
      */
     notifyParticipants?: boolean | null;
-    /** Optional custom message to send. */
+    /**
+     * Message to send.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     message?: string | null;
 }
 interface UpdateScheduleResponse$1 {
@@ -3465,7 +3644,7 @@ interface Schedule {
      *
      * Supported values:
      * - `ACTIVE`: You can add events to the schedule or update its fields.
-     * - `CANCELLED` You can't add events to the schedule or update its fields.
+     * - `CANCELLED`: You can't add events to the schedule or update its fields.
      *
      * Default: `ACTIVE`
      * @readonly
@@ -3559,48 +3738,74 @@ declare enum Status$2 {
 }
 interface Location {
     /**
-     * The location ID. Optional.
-     * Currently only supported for locations of type `BUSINESS`, and used to reference the Wix Business Location.
+     * [Location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * ID. Available only for `BUSINESS` locations.
      */
     _id?: string | null;
     /**
-     * The location type.
-     * The possible values are:
-     * - `"BUSINESS"` event takes place at the business location.
-     * - `"CUSTOMER"` event takes place at the customer location.
-     * - `"CUSTOM"` event takes place at the custom location.
+     * Location type.
+     *
+     * Supported values:
+     * + `BUSINESS`: The event is held at a business location.
+     * + `CUSTOMER`: The event is held at the customer's location, such as their home or office.
+     * + `CUSTOM`: The event is held at an address or venue not tied to the business or customer.
      */
     type?: LocationType;
     /**
-     * The location name. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location name. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)
+     * `name`.
+     *
+     * Min: 1 character
+     * Max: 150 characters
      */
     name?: string | null;
     /**
-     * The location address. Optional.
-     * Derived from the Wix Business Location if the location is of type `BUSINESS`.
+     * Location address. For `BUSINESS` locations, it's identical to the
+     * [location](https://dev.wix.com/docs/rest/business-management/locations/location-object)'s
+     * `formattedAddress`.
      */
     address?: string | null;
 }
 declare enum LocationType {
     UNKNOWN_TYPE = "UNKNOWN_TYPE",
-    /** The event takes place at the business location. */
+    /** The event is held at a business location. */
     BUSINESS = "BUSINESS",
-    /** The event takes place at the customer location. */
+    /** The event is held at the customer's location, such as their home or office. */
     CUSTOMER = "CUSTOMER",
-    /** The event takes place at the custom location. */
+    /** The event is held at an address or venue not tied to the business or customer. */
     CUSTOM = "CUSTOM"
 }
 interface ConferencingDetails {
-    /** World known conference type, such as Zoom. */
+    /** Conference type. For example, `Zoom`. */
     type?: Type;
-    /** URL used by the host to start the conference. */
+    /**
+     * URL used by the host to start the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     hostUrl?: string | null;
-    /** URL used by a guest to join the conference. */
+    /**
+     * URL used by a guest to join the conference.
+     *
+     * Min: 1 character
+     * Max: 2000 characters
+     */
     guestUrl?: string | null;
-    /** Optional conference password. */
+    /**
+     * Conference password.
+     *
+     * Min: 1 character
+     * Max: 100 characters
+     */
     password?: string | null;
-    /** Optional conference ID in an external system. */
+    /**
+     * Conference ID in an external system.
+     *
+     * Min: 1 character
+     * Max: 150 characters
+     */
     externalId?: string | null;
 }
 declare enum Type {
@@ -3609,14 +3814,17 @@ declare enum Type {
     CUSTOM = "CUSTOM"
 }
 interface Permission {
-    /** The identity granted the permission. */
+    /**
+     * [Wix user](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities#wix-users)
+     * granted the permission.
+     */
     identity?: CommonIdentificationData;
     /**
-     * The permission role.
+     * Permission role.
      *
-     * The possible values are:
-     * - `"WRITER"` Role grants full write and read access.
-     * - `"COMMENTER"` Role grants full read access and permission to edit notes.
+     * Supported values:
+     * + `WRITER`: Full read and write access.
+     * + `COMMENTER`: Full read access, write access limited to `event.notes`.
      */
     role?: Role;
 }
@@ -3641,9 +3849,9 @@ declare enum IdentityType {
 }
 declare enum Role {
     UNKNOWN_ROLE = "UNKNOWN_ROLE",
-    /** Role grants full write and read access. */
+    /** Full read and write access. */
     WRITER = "WRITER",
-    /** Role grants full read access and permission to edit notes. */
+    /** Full read access, write access limited to `event.notes`. */
     COMMENTER = "COMMENTER"
 }
 interface ExtendedFields {
@@ -3790,11 +3998,17 @@ interface UpdateScheduleRequest {
 }
 interface ParticipantNotification {
     /**
-     * Whether to notify the participant/s about changes made to the schedule or event.
-     * Default is false.
+     * Whether to notify the participants about changes made to the schedule or event.
+     *
+     * Default: `false`
      */
     notifyParticipants?: boolean | null;
-    /** Optional custom message to send. */
+    /**
+     * Message to send.
+     *
+     * Min: 1 character
+     * Max: 5000 characters
+     */
     message?: string | null;
 }
 interface UpdateScheduleResponse {
@@ -4001,7 +4215,7 @@ interface ListScheduleTimeFramesRequest$1 {
      * IDs of the schedules for which to retrieve schedule time frames.
      *
      * Min: 1 schedule ID
-     * Max: 100 schdule IDs
+     * Max: 100 schedule IDs
      */
     ids: string[];
     /**
@@ -4140,7 +4354,7 @@ interface ListScheduleTimeFramesRequest {
      * IDs of the schedules for which to retrieve schedule time frames.
      *
      * Min: 1 schedule ID
-     * Max: 100 schdule IDs
+     * Max: 100 schedule IDs
      */
     ids: string[];
     /**