---
title: "Replace services"
method: PUT
path: "/v1/accounts/{accountId}/gmb-services"
tags: ["GMB Services"]
---

# Replace services

`PUT /v1/accounts/{accountId}/gmb-services`

Replaces the entire service list for a location.
Google's API requires full replacement; individual item updates are not supported.
Each service can be structured (using a predefined serviceTypeId) or free-form (custom label).

## Path parameters

- `accountId` string, required

## Query parameters

- `locationId` string

## Request body

- object
  - `serviceItems` object[], required
    - `structuredServiceItem` object — Exactly one of structuredServiceItem or freeFormServiceItem is required per item (enforced server-side; not modeled as oneOf because required-only oneOf branches break SDK generators).
      - `serviceTypeId` string, required
      - `description` string
    - `freeFormServiceItem` object
      - `category` string, required
      - `label` object, required
        - `displayName` string, required
        - `description` string
        - `languageCode` string
    - `price` object
      - `currencyCode` string
      - `units` string
      - `nanos` integer

## Response `200`

Services updated successfully

- object
  - `success` boolean
  - `services` object[]

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 2 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `401` status
- **2026-09-15** `0dba7d004d75` — 4 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `401` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `401` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/gmb-services/put.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/339f59df69dd?raw)