Skip to content

Update a service

Request

Partially updates a service with a merge-patch body. type is immutable; for package services, package.components replaces the full component list when present. Team Member links are written through updateTeamMemberServices, not here.

Security
OAuth2(Required scopes: services:write) or ApiKey
Path
location_idintegerrequired

Identifier of the Location. Verified against the credential on every call — a Location the credential cannot access responds with 404.

service_idintegerrequired

Identifier of the service.

Bodyapplication/merge-patch+jsonrequired
namestring
category_idinteger
duration_secondsinteger
packageobject(ServicePackageCreate)

Only for package services; components replaces the whole list.

price_min_minorinteger

Integer minor units of the Location currency.

curl -i -X PATCH \
  'https://developer.alteg.io/_mock/en/b2b-v3/openapi/locations/{location_id}/services/{service_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/merge-patch+json' \
  -d '{
    "price_min_minor": 280000
  }'

Responses

The updated service.

Headers
RateLimit-Remaininginteger, (int32), >= 0

Requests left in the most constrained policy window that applies to this request.

RateLimit-Resetinteger, (int32), >= 0

On 429, seconds until the most constrained policy frees up; it equals Retry-After there. On a successful response it reports the length of that policy's window rather than the time left in the current one, so treat it as the window size, not as a countdown — the counter to pace against is RateLimit-Remaining.

RateLimit-Policystring

Most constrained policy applied to the request, as <limit>;w=<window in seconds>.

Example:"10;w=60"
X-Request-Idstring

Request identifier for support and log correlation.

Bodyapplication/json
idintegerread-onlyrequired
objectstringread-onlyrequired
Value:"service"
typestringrequired

Service kind. Immutable after creation (422 field_immutable). A package service bundles several simple services of the same Location; it appears in the same list and is scheduled by the same service_id.

Default:"simple"
Enum:"simple""package"
namestringrequired

Internal name shown to the business in Altegio, as the business entered it; not translated.

online_booking_namestringread-onlyrequired

Client-facing name shown in online booking, as the business entered it; equals name when no separate online booking name is set. Not translated.

category_idinteger or nullrequired

Service category (listServiceCategories); null when the category is not listed in this Location.

duration_secondsintegerrequired

Default duration of the service in seconds (the Location-wide default, 3600 when none is set).

weightintegerread-onlyrequired

Display order the business set in Altegio (higher first). Lists are ordered by id; sort by weight on the client.

price_min_minorintegerrequired

Base price of the service in this Location, integer minor units of the Location currency, as set by the business: a single price or the lower bound of a range. For a package, the package price stored in Altegio. Team Member prices by grade can differ.

price_max_minorinteger or nullrequired

Upper bound of the base price range, integer minor units of the Location currency; equals price_min_minor for a single price; null for a legacy "from" price without an upper bound.

currencystringread-onlyrequired

ISO 4217, server-controlled by the Location.

online_booking_enabledbooleanread-onlyrequired

The business's online booking setting for this service in the Location. It does not mean that free time is available; free slots come from the availability operations.

team_membersArray of objects(ServiceTeamMemberLink)read-onlyrequired

Team Members providing this service, by id. Read-only here; links are written through updateTeamMemberServices.

packageServicePackage (object) or nullrequired
One of:

Package settings and components of a service with type: package.

created_atstring or null, (date-time)read-onlyrequired

UTC; null when the creation date is not stored.

Response
{ "id": 100, "object": "service", "type": "simple", "name": "Men's haircut", "online_booking_name": "Haircut for men", "category_id": 205, "duration_seconds": 3600, "weight": 2, "currency": "EUR", "online_booking_enabled": true, "team_members": [ { … }, { … } ], "package": null, "created_at": "2026-07-01T08:00:00Z", "price_min_minor": 250000, "price_max_minor": 300000 }