नेविगेशन पर जाएँ

Confirm Service Update

Save a service update that changes the price of existing bookings. Optionally reprice future bookings.

पाथ पैरामीटर

service_idstringआवश्यक

हेडर

xi-api-keystringवैकल्पिक
xi-workspace-idstring or nullवैकल्पिक
The customer workspace a reseller's API key acts on.

क्वेरी पैरामीटर

repricebooleanवैकल्पिकडिफ़ॉल्ट: false

अनुरोध

This endpoint expects an object.
pricing_modeenumवैकल्पिकडिफ़ॉल्ट: fixed

‘fixed’ (default): the item has a known price the agent can quote, and customers can book or order it directly. ‘quote’: the price depends on the job (renovation, catering, custom work), so no price or slot is offered; the agent collects the intake_questions and files a quote request instead. Takes effect only while quotes are enabled for the business. Group services cannot use ‘quote’.

अनुमत मान:
intake_questionslist of objectsवैकल्पिक

Questions the agent asks before booking or ordering this item. Required for a useful pricing_mode='quote' item — without them a quote request arrives with nothing to price — but also valid on fixed-price items that need extra detail (current hair color before a dye job, allergies before a treatment).

groupslist of objectsवैकल्पिक

Group memberships for this item. Each entry carries the group label and the item’s 0-based rank within that group.

ungrouped_rankinteger or nullवैकल्पिक

Display position among items with no group; null sorts last. Change it with the reorder endpoint.

namestringवैकल्पिक
descriptionstringवैकल्पिक
variantslist of objectsवैकल्पिक

Bookable options for this service. Always non-empty; variants[0] is the default option shown when callers don’t pick a specific variant. Each entry has its own duration and (optional) price, and uniqueness is keyed by duration.

kindenumवैकल्पिकडिफ़ॉल्ट: classic

Classic = staff-delivered; rental = asset-based; group = multi-participant session.

अनुमत मान:
buffer_minutesintegerवैकल्पिक

Turnover/cleanup time reserved after each booking. Applies to every service kind; default 0 means no buffer.

service_locationenumवैकल्पिकडिफ़ॉल्ट: business

Where the service is delivered. business = client visits the business location (default); customer = staff travels to the client. Only meaningful for kind='classic'.

अनुमत मान:
add_onslist of objectsवैकल्पिक
Optional extras that can be added to a booking of this service.
max_participantsinteger or nullवैकल्पिक2-200

Capacity for kind='group': how many seats a single session can sell across all registrations. Must be null for classic and rental services (those are always exclusive to one client per booking).

capacityinteger or nullवैकल्पिक
is_activebooleanवैकल्पिक
any_staff_memberbooleanवैकल्पिक
staff_idslist of stringsवैकल्पिक

Staff assigned to this service; must be empty for kind=‘rental’.

asset_idslist of stringsवैकल्पिक
advance_booking_minutesintegerवैकल्पिक

How far into the future customer-facing channels (public booking page, voice agent) may book this service. Applies to every kind.

location_idslist of stringsवैकल्पिक

Locations where this service is offered; empty list means all locations.

display_on_booking_pagebooleanवैकल्पिक
travel_minutesintegerवैकल्पिक

Travel time in minutes added before/after appointments for customer-location services. Blocks the staff member’s calendar but is not visible to the customer. Ignored when service_location='business'.

travel_beforebooleanवैकल्पिक

Add travel time before the appointment (outbound trip).

travel_afterbooleanवैकल्पिक

Add travel time after the appointment (return trip).

promotionslist of objectsवैकल्पिक

Time-bound discounts applicable to this service or specific variants.

duration_minutesinteger or nullवैकल्पिक<=43200

Sets the first variant’s duration. Ignored when variants is sent.

pricedouble or nullवैकल्पिक>=0

Sets the first variant’s price. Ignored when variants is sent.

रिस्पॉन्स

सफल रिस्पॉन्स

has_affected_eventsboolean
serviceobject or nullवैकल्पिक

Represents a bookable service (e.g., haircut, massage, consultation).

त्रुटियाँ

422
Unprocessable Entity Error