> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # BulkUpdateServicesByFilter # Package: services # Namespace: ServicesService # Method link: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/bulk-update-services-by-filter.md ## Permission Scopes: Manage Bookings: SCOPE.DC-BOOKINGS.MANAGE-BOOKINGS ## Introduction Updates multiple services by filter. See [Query Services](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services.md) for a list of supported filters. See [Update Service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/update-service.md) for more details about updating a service. The call succeeds even if one or more individual services can't be updated. Information about failures is returned in `bulkActionMetadata`. --- ## REST API ### Schema ``` Method: bulkUpdateServicesByFilter Description: Updates multiple services by filter. See [Query Services](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services.md) for a list of supported filters. See [Update Service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/update-service.md) for more details about updating a service. The call succeeds even if one or more individual services can't be updated. Information about failures is returned in `bulkActionMetadata`. URL: https://www.wixapis.com/bookings/v2/bulk/services/update-by-filter Method: POST # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: filter, service Method parameters: param name: filter | type: filter | description: Filter to identify the services to update. | required: true param name: service | type: Service | description: The `service` object represents an offering that a business provides to its customers. | required: true - name: appId | type: string | description: GUID of the app associated with the service. You can't update `appId`. Services are displayed in Wix Bookings only if they are associated with the Wix Bookings appId or have no associated app GUID. Default: `13d21c63-b5ec-5912-8397-c3a5ddb27a97` (Wix Bookings app GUID) For services from Wix apps, the following values apply: - Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` - Wix Services: `"cc552162-24a4-45e0-9695-230c4931ef40"` - Wix Meetings: `"6646a75c-2027-4f49-976c-58f3d713ed0f"`. [Full list of apps created by Wix](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md). - name: type | type: ServiceType | description: Service type. Learn more about [service types](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-types.md). - enum: - APPOINTMENT: Appointment-based service. - CLASS: Class service. - COURSE: Course service. - name: sortOrder | type: integer | description: Order of the service within a [category](https://dev.wix.com/docs/rest/business-solutions/bookings/services/categories-v1/category-object.md). - name: name | type: string | description: Service name. - name: description | type: string | description: Service description. For example, `High-class hair styling, cuts, straightening and color`. - name: tagLine | type: string | description: Short service description, such as `Hair styling`. - name: defaultCapacity | type: integer | description: Default maximum number of customers that can book the service. The service cannot be booked beyond this capacity. - name: media | type: Media | description: Media associated with the service. - name: items | type: array | description: Media items associated with the service. - ONE-OF: - name: image | type: Image | description: Details of the image associated with the service, such as URL and size. - name: id | type: string | description: WixMedia image GUID. (e.g. "4b3901ffcb8d7ad81a613779d92c9702.jpg") - name: url | type: string | description: Image URL. (similar to image.id e.g. "4b3901ffcb8d7ad81a613779d92c9702.jpg") - name: height | type: integer | description: Original image height. - name: width | type: integer | description: Original image width. - name: altText | type: string | description: Image alt text. - name: mainMedia | type: MediaItem | description: Primary media associated with the service. - name: coverMedia | type: MediaItem | description: Cover media associated with the service. - name: hidden | type: boolean | description: Whether the service is hidden from Wix Bookings pages and widgets. - name: category | type: Category | description: [Category](https://dev.wix.com/docs/rest/business-solutions/bookings/services/categories-v2/introduction.md) the service is associated with. Services aren't automatically assigned to a category. Without an associated category, the service isn't visible on the live site. - name: id | type: string | description: Category GUID. - name: form | type: Form | description: Form the customer filled out when booking the service. - name: id | type: string | description: GUID of the form associated with the service. The form information that you submit when booking includes contact details, participants, and other form fields set up for the service. You can manage the service booking form fields using the Bookings Forms API. - name: payment | type: Payment | description: Payment options for booking the service. Learn more about [service payments](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-payments.md). - ONE-OF: - name: fixed | type: FixedPayment | description: The details for the fixed price of the service. Required when: `rateType` is `FIXED` - name: price | type: Money | description: The fixed price required to book the service. Required when: `rateType` is `FIXED` - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator. For example `25.05`. - name: formattedValue | type: string | description: Monetary amount. Decimal string in local format. For example, `1 000,30`. - name: deposit | type: Money | description: The deposit price required to book the service. Required when: `rateType` is `FIXED` and `paymentOptions.deposit` is `true` - name: fullUpfrontPaymentAllowed | type: boolean | description: Whether customers can choose to pay the full service price upfront instead of only the deposit. Used only when a `deposit` amount is set. Default: `false`. - name: custom | type: CustomPayment | description: The details for the custom price of the service. Required when: `rateType` is `CUSTOM` - name: description | type: string | description: A custom description explaining to the customer how to pay for the service. - name: varied | type: VariedPayment | description: The details for the varied pricing of the service. Read more about [varied price options](https://support.wix.com/en/article/wix-bookings-about-getting-paid-online#offering-varied-price-options). Required when: `rateType` is `VARIED` - name: defaultPrice | type: Money | description: The default price for the service without any variants. It will also be used as the default price for any new variant. - name: deposit | type: Money | description: The deposit price required to book the service. Required when: `rateType` is `VARIED` and `paymentOptions.deposit` is `true` - name: fullUpfrontPaymentAllowed | type: boolean | description: Whether customers can choose to pay the full service price upfront instead of only the deposit. Used only when a `deposit` amount is set. Default: `false`. - name: rateType | type: RateType | description: The rate the customer is expected to pay for the service. - enum: - FIXED: The service has a fixed price. - CUSTOM: The service has a custom price, expressed as a price description. - VARIED: This service is offered with a set of different prices based on different terms. - NO_FEE: This service is offered free of charge. - name: options | type: PaymentOptions | description: The payment options a customer can use to pay for the service. - name: online | type: boolean | description: Customers can pay for the service online. When `true`: + `rateType` must be `FIXED` or `VARIED`. + `fixed.price` or `varied.defaultPrice` must be specified respectively. Read more about [getting paid online](https://support.wix.com/en/article/wix-bookings-about-getting-paid-online). - name: inPerson | type: boolean | description: Customers can pay for the service in person. - name: deposit | type: boolean | description: This service requires a deposit to be made online in order to book it. When `true`: + `rateType` must be `VARIED` or `FIXED`. + A `deposit` must be specified. - name: pricingPlan | type: boolean | description: Whether customers can pay for the service using a pricing plan. Read more about [service payment options](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments.md). - name: addOnOption | type: AddOnPaymentOptions | description: How customers can pay for add-ons when paying for the related booking with a [pricing plan](https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/pricing-plans/introduction.md). If customers pay for the booking using any method other than a pricing plan, the value of this field is ignored. - enum: - ONLINE: Customers are required to pay online for add-ons when the booking is paid for with a pricing plan. - IN_PERSON: Customers are required to pay in person for add-ons when the booking is paid for with a pricing plan. - name: onlineBooking | type: OnlineBooking | description: Online booking settings. - name: enabled | type: boolean | description: Whether the service can be booked online. When set to `true`, customers can book the service online. Configure the payment options via the `service.payment` property. When set to `false`, customers cannot book the service online, and the service can only be paid for in person. - name: requireManualApproval | type: boolean | description: Booking the service requires approval by the Wix user. - name: allowMultipleRequests | type: boolean | description: Multiple customers can request to book the same time slot. This is relevant when `requireManualApproval` is `true`. - name: conferencing | type: Conferencing | description: Conferencing options for the service. - name: enabled | type: boolean | description: Whether a conference link is generated for the service's sessions. - name: locations | type: array | description: The locations this service is offered at. Read more about [service locations](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-locations.md). - ONE-OF: - name: business | type: BusinessLocationOptions | description: Information about business locations. - name: id | type: string | description: GUID of the business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). When setting a business location, specify only the location GUID. Other location details are overwritten. - name: custom | type: CustomLocationOptions | description: Information about custom locations. - name: address | type: Address | description: Address of the custom location. - ONE-OF: - name: streetAddress | type: StreetAddress | description: Street name and number. - name: number | type: string | description: Street number. - name: name | type: string | description: Street name. - name: apt | type: string | description: Apartment number. - name: addressLine | type: string | description: - name: country | type: string | description: 2-letter country code in an [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. - name: subdivision | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) format. - name: city | type: string | description: City name. - name: postalCode | type: string | description: Postal or zip code. - name: formattedAddress | type: string | description: Full address of the location. - name: type | type: LocationType | description: Location type. Default: `CUSTOM` - enum: - CUSTOM: Location set by the business that is not a standard business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). - BUSINESS: Business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). - CUSTOMER: The customer specifies any address when booking. Available only for appointment-based services. - name: bookingPolicy | type: BookingPolicy | description: [Policy](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction.md) determining under what conditions this service can be booked. For example, whether the service can only be booked up to 30 minutes before it begins. - name: id | type: string | description: The GUID to the policy for the booking. - name: schedule | type: Schedule | description: The service's [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction.md), which can be used to manage the service's [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md). - name: availabilityConstraints | type: AvailabilityConstraints | description: Limitations affecting the service availability. - name: sessionDurations | type: array | description: List of supported session durations in minutes. - For appointment-based services, specify `sessionDurations` when creating a service. - For appointment-based services with varied pricing by session length, you must still specify `sessionDurations`, but the values are ignored. Actual durations are taken from the [service variants](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/service-options-and-variants/introduction.md). - For classes or courses, don't specify `sessionDurations` when creating a service. Min: `1` minute Max: `44639` minutes (30 days, 23 hours, and 59 minutes) - name: timeBetweenSessions | type: integer | description: The number of minutes between the end of a session and the start of the next. Min: `0` minutes Max: `720` minutes - name: staffMemberIds | type: array | description: IDs of the [resources](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resources-v2/introduction.md) associated with the [staff members](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/introduction.md) providing the service. Note that these are the resource GUIDs, not the staff member GUIDs. For appointment-based services, set this field when creating or updating the service. For classes and courses, this field is read-only and is automatically derived from staff assigned to the service's recurring scheduled sessions. Staff assigned only to single, non-recurring events are not included. Once all of a staff member's upcoming recurring sessions have ended, their GUID is removed from this field. To retrieve the full list of staff for classes or courses, query the service's calendar events instead. Learn more about [retrieving staff for classes and courses](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/sample-flows.md#retrieve-staff-members-for-a-class-or-course). - name: staffMemberDetails | type: StaffMemberDetails | description: Staff members details. Returned only if `STAFF_MEMBER_DETAILS` conditional field was specified. - name: staffMembers | type: array | description: Staff members providing the service. For appointments only. - name: serviceResources | type: array | description: Information about which resources must be available so customers can book the service. For example, a meeting room or equipment. - name: resourceType | type: ResourceType | description: Details about the required [resource type](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resource-types-v2/introduction.md). - name: id | type: string | description: The type of the resource. - name: extendedFields | type: ExtendedFields | description: Extensions enabling users to save custom data related to the service. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: seoData | type: SeoSchema | description: Custom SEO data for the service. - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. - name: addOnGroups | type: array | description: Information about the [add-on groups](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-add-on-groups.md) associated with the service. - name: name | type: string | description: Name of the add-on group. - name: maxNumberOfAddOns | type: integer | description: Maximum number of different [add-ons](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/introduction.md) from the group customers can add when booking the service. When empty, there's no upper limit. - name: addOnIds | type: array | description: List of GUIDs of all [add-ons](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/introduction.md) included in the group. - name: prompt | type: string | description: Description or instructional prompt of the add-on group that's displayed to customers when booking the service. - name: taxableAddress | type: TaxableAddress | description: Taxable address used to calculate tax - name: taxableAddressType | type: TaxableAddressType | description: Taxable address type. - enum: BUSINESS, BILLING Return type: BulkUpdateServicesByFilterResponse - name: jobId | type: string | description: GUID of the service update job. Pass this GUID to [Get Async Job](https://dev.wix.com/docs/rest/business-management/async-job/introduction.md) to retrieve job details and metadata. ``` ### Examples ### Update the default capacity of all services of type CLASS ```curl curl -X POST 'https://www.wixapis.com/bookings/v2/bulk/services/update-by-filter' \ -H 'Authorization: ' \ -d '{ "service": { "defaultCapacity": 25 }, "filter": { "type": "CLASS" }, "mask": { "paths": [ "defaultCapacity" ] } }' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.services.ServicesService.bulkUpdateServicesByFilter(filter, options) Description: Updates multiple services by filter. See [Query Services](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services.md) for a list of supported filters. See [Update Service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/update-service.md) for more details about updating a service. The call succeeds even if one or more individual services can't be updated. Information about failures is returned in `bulkActionMetadata`. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: filter, service, options Method parameters: param name: filter | type: object | description: Filter to identify the services to update. | required: true param name: options | type: BulkUpdateServicesByFilterOptions none | required: true - name: service | type: Service | description: Service to update. | required: true - name: appId | type: string | description: GUID of the app associated with the service. You can't update `appId`. Services are displayed in Wix Bookings only if they are associated with the Wix Bookings appId or have no associated app GUID. Default: `13d21c63-b5ec-5912-8397-c3a5ddb27a97` (Wix Bookings app GUID) For services from Wix apps, the following values apply: - Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` - Wix Services: `"cc552162-24a4-45e0-9695-230c4931ef40"` - Wix Meetings: `"6646a75c-2027-4f49-976c-58f3d713ed0f"`. [Full list of apps created by Wix](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md). - name: type | type: ServiceType | description: Service type. Learn more about [service types](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-types.md). - enum: - APPOINTMENT: Appointment-based service. - CLASS: Class service. - COURSE: Course service. - name: sortOrder | type: integer | description: Order of the service within a [category](https://dev.wix.com/docs/rest/business-solutions/bookings/services/categories-v1/category-object.md). - name: name | type: string | description: Service name. - name: description | type: string | description: Service description. For example, `High-class hair styling, cuts, straightening and color`. - name: tagLine | type: string | description: Short service description, such as `Hair styling`. - name: defaultCapacity | type: integer | description: Default maximum number of customers that can book the service. The service cannot be booked beyond this capacity. - name: media | type: Media | description: Media associated with the service. - name: items | type: array | description: Media items associated with the service. - ONE-OF: - name: image | type: string | description: Details of the image associated with the service, such as URL and size. - name: mainMedia | type: MediaItem | description: Primary media associated with the service. - name: coverMedia | type: MediaItem | description: Cover media associated with the service. - name: hidden | type: boolean | description: Whether the service is hidden from Wix Bookings pages and widgets. - name: category | type: Category | description: [Category](https://dev.wix.com/docs/rest/business-solutions/bookings/services/categories-v2/introduction.md) the service is associated with. Services aren't automatically assigned to a category. Without an associated category, the service isn't visible on the live site. - name: _id | type: string | description: Category GUID. - name: form | type: Form | description: Form the customer filled out when booking the service. - name: _id | type: string | description: GUID of the form associated with the service. The form information that you submit when booking includes contact details, participants, and other form fields set up for the service. You can manage the service booking form fields using the Bookings Forms API. - name: payment | type: Payment | description: Payment options for booking the service. Learn more about [service payments](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-payments.md). - ONE-OF: - name: fixed | type: FixedPayment | description: The details for the fixed price of the service. Required when: `rateType` is `FIXED` - name: price | type: Money | description: The fixed price required to book the service. Required when: `rateType` is `FIXED` - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator. For example `25.05`. - name: formattedValue | type: string | description: Monetary amount. Decimal string in local format. For example, `1 000,30`. - name: deposit | type: Money | description: The deposit price required to book the service. Required when: `rateType` is `FIXED` and `paymentOptions.deposit` is `true` - name: fullUpfrontPaymentAllowed | type: boolean | description: Whether customers can choose to pay the full service price upfront instead of only the deposit. Used only when a `deposit` amount is set. Default: `false`. - name: custom | type: CustomPayment | description: The details for the custom price of the service. Required when: `rateType` is `CUSTOM` - name: description | type: string | description: A custom description explaining to the customer how to pay for the service. - name: varied | type: VariedPayment | description: The details for the varied pricing of the service. Read more about [varied price options](https://support.wix.com/en/article/wix-bookings-about-getting-paid-online#offering-varied-price-options). Required when: `rateType` is `VARIED` - name: defaultPrice | type: Money | description: The default price for the service without any variants. It will also be used as the default price for any new variant. - name: deposit | type: Money | description: The deposit price required to book the service. Required when: `rateType` is `VARIED` and `paymentOptions.deposit` is `true` - name: fullUpfrontPaymentAllowed | type: boolean | description: Whether customers can choose to pay the full service price upfront instead of only the deposit. Used only when a `deposit` amount is set. Default: `false`. - name: rateType | type: RateType | description: The rate the customer is expected to pay for the service. - enum: - FIXED: The service has a fixed price. - CUSTOM: The service has a custom price, expressed as a price description. - VARIED: This service is offered with a set of different prices based on different terms. - NO_FEE: This service is offered free of charge. - name: options | type: PaymentOptions | description: The payment options a customer can use to pay for the service. - name: online | type: boolean | description: Customers can pay for the service online. When `true`: + `rateType` must be `FIXED` or `VARIED`. + `fixed.price` or `varied.defaultPrice` must be specified respectively. Read more about [getting paid online](https://support.wix.com/en/article/wix-bookings-about-getting-paid-online). - name: inPerson | type: boolean | description: Customers can pay for the service in person. - name: deposit | type: boolean | description: This service requires a deposit to be made online in order to book it. When `true`: + `rateType` must be `VARIED` or `FIXED`. + A `deposit` must be specified. - name: pricingPlan | type: boolean | description: Whether customers can pay for the service using a pricing plan. Read more about [service payment options](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-service-payments.md). - name: addOnOption | type: AddOnPaymentOptions | description: How customers can pay for add-ons when paying for the related booking with a [pricing plan](https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/pricing-plans/introduction.md). If customers pay for the booking using any method other than a pricing plan, the value of this field is ignored. - enum: - ONLINE: Customers are required to pay online for add-ons when the booking is paid for with a pricing plan. - IN_PERSON: Customers are required to pay in person for add-ons when the booking is paid for with a pricing plan. - name: onlineBooking | type: OnlineBooking | description: Online booking settings. - name: enabled | type: boolean | description: Whether the service can be booked online. When set to `true`, customers can book the service online. Configure the payment options via the `service.payment` property. When set to `false`, customers cannot book the service online, and the service can only be paid for in person. - name: requireManualApproval | type: boolean | description: Booking the service requires approval by the Wix user. - name: allowMultipleRequests | type: boolean | description: Multiple customers can request to book the same time slot. This is relevant when `requireManualApproval` is `true`. - name: conferencing | type: Conferencing | description: Conferencing options for the service. - name: enabled | type: boolean | description: Whether a conference link is generated for the service's sessions. - name: locations | type: array | description: The locations this service is offered at. Read more about [service locations](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-locations.md). - ONE-OF: - name: business | type: BusinessLocationOptions | description: Information about business locations. - name: _id | type: string | description: GUID of the business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). When setting a business location, specify only the location GUID. Other location details are overwritten. - name: custom | type: CustomLocationOptions | description: Information about custom locations. - name: address | type: Address | description: Address of the custom location. - name: city | type: string | description: none - name: subdivision | type: string | description: none - name: country | type: string | description: none - name: postalCode | type: string | description: none - name: addressLine1 | type: string | description: none - name: type | type: LocationType | description: Location type. Default: `CUSTOM` - enum: - CUSTOM: Location set by the business that is not a standard business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). - BUSINESS: Business [location](https://dev.wix.com/docs/api-reference/business-management/locations/introduction.md). - CUSTOMER: The customer specifies any address when booking. Available only for appointment-based services. - name: bookingPolicy | type: BookingPolicy | description: [Policy](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction.md) determining under what conditions this service can be booked. For example, whether the service can only be booked up to 30 minutes before it begins. - name: _id | type: string | description: The GUID to the policy for the booking. - name: schedule | type: Schedule | description: The service's [schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction.md), which can be used to manage the service's [events](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction.md). - name: availabilityConstraints | type: AvailabilityConstraints | description: Limitations affecting the service availability. - name: sessionDurations | type: array | description: List of supported session durations in minutes. - For appointment-based services, specify `sessionDurations` when creating a service. - For appointment-based services with varied pricing by session length, you must still specify `sessionDurations`, but the values are ignored. Actual durations are taken from the [service variants](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/service-options-and-variants/introduction.md). - For classes or courses, don't specify `sessionDurations` when creating a service. Min: `1` minute Max: `44639` minutes (30 days, 23 hours, and 59 minutes) - name: timeBetweenSessions | type: integer | description: The number of minutes between the end of a session and the start of the next. Min: `0` minutes Max: `720` minutes - name: staffMemberIds | type: array | description: IDs of the [resources](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resources-v2/introduction.md) associated with the [staff members](https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/introduction.md) providing the service. Note that these are the resource GUIDs, not the staff member GUIDs. For appointment-based services, set this field when creating or updating the service. For classes and courses, this field is read-only and is automatically derived from staff assigned to the service's recurring scheduled sessions. Staff assigned only to single, non-recurring events are not included. Once all of a staff member's upcoming recurring sessions have ended, their GUID is removed from this field. To retrieve the full list of staff for classes or courses, query the service's calendar events instead. Learn more about [retrieving staff for classes and courses](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/sample-flows.md#retrieve-staff-members-for-a-class-or-course). - name: staffMemberDetails | type: StaffMemberDetails | description: Staff members details. Returned only if `STAFF_MEMBER_DETAILS` conditional field was specified. - name: staffMembers | type: array | description: Staff members providing the service. For appointments only. - name: serviceResources | type: array | description: Information about which resources must be available so customers can book the service. For example, a meeting room or equipment. - name: resourceType | type: ResourceType | description: Details about the required [resource type](https://dev.wix.com/docs/api-reference/business-solutions/bookings/resources/resource-types-v2/introduction.md). - name: _id | type: string | description: The type of the resource. - name: extendedFields | type: ExtendedFields | description: Extensions enabling users to save custom data related to the service. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: seoData | type: SeoSchema | description: Custom SEO data for the service. - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. - name: addOnGroups | type: array | description: Information about the [add-on groups](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/about-add-on-groups.md) associated with the service. - name: name | type: string | description: Name of the add-on group. - name: maxNumberOfAddOns | type: integer | description: Maximum number of different [add-ons](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/introduction.md) from the group customers can add when booking the service. When empty, there's no upper limit. - name: addOnIds | type: array | description: List of GUIDs of all [add-ons](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/introduction.md) included in the group. - name: prompt | type: string | description: Description or instructional prompt of the add-on group that's displayed to customers when booking the service. - name: taxableAddress | type: TaxableAddress | description: Taxable address used to calculate tax - name: taxableAddressType | type: TaxableAddressType | description: Taxable address type. - enum: BUSINESS, BILLING Return type: PROMISE - name: jobId | type: string | description: GUID of the service update job. Pass this GUID to [Get Async Job](https://dev.wix.com/docs/rest/business-management/async-job/introduction.md) to retrieve job details and metadata. ``` ### Examples ### bulkUpdateServicesByFilter ```javascript import { services } from '@wix/bookings'; async function bulkUpdateServicesByFilter(filter,options) { const response = await services.bulkUpdateServicesByFilter(filter,options); }; ``` ### bulkUpdateServicesByFilter (with elevated permissions) ```javascript import { services } from '@wix/bookings'; import { auth } from '@wix/essentials'; async function myBulkUpdateServicesByFilterMethod(filter,options) { const elevatedBulkUpdateServicesByFilter = auth.elevate(services.bulkUpdateServicesByFilter); const response = await elevatedBulkUpdateServicesByFilter(filter,options); } ``` ### bulkUpdateServicesByFilter (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { services } from '@wix/bookings'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { services }, // Include the auth strategy and host as relevant }); async function bulkUpdateServicesByFilter(filter,options) { const response = await myWixClient.services.bulkUpdateServicesByFilter(filter,options); }; ``` ---