Confirm Service Update

POST

/v1/reception/services/:service_id/confirm-update

POST

/v1/reception/services/:service_id/confirm-update

curl -X POST https://api.elevenlabs.io/v1/reception/services/service_id/confirm-update \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "has_affected_events": true,
  "service": {
    "name": "string",
    "variants": [
      {
        "duration_minutes": 1,
        "id": "string",
        "price": 1.1,
        "is_active": true
      }
    ],
    "_id": "string",
    "duration_minutes": 1,
    "price": 1.1,
    "pricing_mode": "fixed",
    "intake_questions": [
      {
        "label": "string",
        "id": "string",
        "kind": "text",
        "options": [
          "string"
        ],
        "required": false,
        "is_active": true
      }
    ],
    "groups": [
      {
        "label": "string",
        "rank": 0
      }
    ],
    "ungrouped_rank": 1,
    "description": "string",
    "kind": "classic",
    "buffer_minutes": 0,
    "service_location": "business",
    "add_ons": [
      {
        "name": "string",
        "id": "string",
        "description": "string",
        "add_duration_minutes": 0,
        "add_price": 0
      }
    ],
    "max_participants": 1,
    "capacity": 1,
    "is_active": true,
    "any_staff_member": true,
    "staff_ids": [
      "string"
    ],
    "asset_ids": [
      "string"
    ],
    "advance_booking_minutes": 1440,
    "location_ids": [
      "string"
    ],
    "display_on_booking_page": true,
    "travel_minutes": 0,
    "travel_before": true,
    "travel_after": true,
    "promotions": [
      {
        "name": "string",
        "promotional_price": 1.1,
        "start_date": "2023-01-15",
        "end_date": "2023-01-15",
        "id": "string",
        "target": "service",
        "variant_id": "string",
        "add_on_id": "string",
        "days_of_week": [
          1
        ],
        "is_active": true
      }
    ],
    "created_at_unix": 1,
    "updated_at_unix": 1
  }
}

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

Parametri di percorso

service_idstringObbligatorio

Parametri di query

repricebooleanOpzionalePredefinito a false

Richiesta

This endpoint expects an object.

pricing_modeenumOpzionalePredefinito a 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’.

Valori consentiti:

intake_questionslist of objectsOpzionale

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 objectsOpzionale

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

ungrouped_rankinteger or nullOpzionale

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

namestringOpzionale

descriptionstringOpzionale

variantslist of objectsOpzionale

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.

kindenumOpzionalePredefinito a classic

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

Valori consentiti:

buffer_minutesintegerOpzionale

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

service_locationenumOpzionalePredefinito a business

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

Valori consentiti:

add_onslist of objectsOpzionale

Optional extras that can be added to a booking of this service.

max_participantsinteger or nullOpzionale2-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 nullOpzionale

is_activebooleanOpzionale

any_staff_memberbooleanOpzionale

staff_idslist of stringsOpzionale

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

asset_idslist of stringsOpzionale

advance_booking_minutesintegerOpzionale

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

location_idslist of stringsOpzionale

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

display_on_booking_pagebooleanOpzionale

travel_minutesintegerOpzionale

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_beforebooleanOpzionale

Add travel time before the appointment (outbound trip).

travel_afterbooleanOpzionale

Add travel time after the appointment (return trip).

promotionslist of objectsOpzionale

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

duration_minutesinteger or nullOpzionale<=43200

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

pricedouble or nullOpzionale>=0

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

Risposta

Risposta riuscita

has_affected_eventsboolean

serviceobject or nullOpzionale

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

Errori

422

Unprocessable Entity Error

Parametri di percorso

Header

Parametri di query

Richiesta

Risposta

Errori