Update Service

PUT

/v1/reception/services/:service_id

PUT

/v1/reception/services/:service_id

curl -X PUT https://api.elevenlabs.io/v1/reception/services/service_id \
     -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
  }
}

Update an existing service. Only the fields sent are changed.

Parametry ścieżki

service_idstringWymagany

Żądanie

This endpoint expects an object.

pricing_modeenumOpcjonalnyDomyślnie 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’.

Dozwolone wartości:

intake_questionslist of objectsOpcjonalny

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 objectsOpcjonalny

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

ungrouped_rankinteger or nullOpcjonalny

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

namestringOpcjonalny

descriptionstringOpcjonalny

variantslist of objectsOpcjonalny

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.

kindenumOpcjonalnyDomyślnie classic

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

Dozwolone wartości:

buffer_minutesintegerOpcjonalny

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

service_locationenumOpcjonalnyDomyślnie business

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

Dozwolone wartości:

add_onslist of objectsOpcjonalny

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

max_participantsinteger or nullOpcjonalny2-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 nullOpcjonalny

is_activebooleanOpcjonalny

any_staff_memberbooleanOpcjonalny

staff_idslist of stringsOpcjonalny

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

asset_idslist of stringsOpcjonalny

advance_booking_minutesintegerOpcjonalny

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

location_idslist of stringsOpcjonalny

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

display_on_booking_pagebooleanOpcjonalny

travel_minutesintegerOpcjonalny

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_beforebooleanOpcjonalny

Add travel time before the appointment (outbound trip).

travel_afterbooleanOpcjonalny

Add travel time after the appointment (return trip).

promotionslist of objectsOpcjonalny

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

duration_minutesinteger or nullOpcjonalny<=43200

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

pricedouble or nullOpcjonalny>=0

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

Odpowiedź

Pomyślna odpowiedź

has_affected_eventsboolean

serviceobject or nullOpcjonalny

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

Błędy

422

Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Żądanie

Odpowiedź

Błędy