---
title: "Update service group"
method: PATCH
path: "/gateway_manager/v1/service-groups/{id}"
tags: ["Gateway Manager"]
---

# Update service group

`PATCH /gateway_manager/v1/service-groups/{id}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gateway_manager/v1/service-groups/{id}`
- Auth: none declared

Updates information about a specific service group.

## Path parameters

- `id` string, required

## Request body

- object
  - `patches` GatewayManagerV1ServiceGroupsIdPatchRequestBodyContentApplicationJsonSchemaPatches
    - `name` string: Updated name for the service group (must be non-empty string, unique to gateway)
    - `description` string: Updated description for the service group
    - `services` string[]: Updated list of service Ids in the service group (must exist and match gateway's cluster_id)
    - `groups` string[]: Updated list of group names allowed to access the service group (group names must exist)

## Response `200`

Result of updating the service group

- GatewayManagerUpdateServiceGroupResponse200
  - `state` string
  - `message` string
  - `result` GatewayManagerV1ServiceGroupsIdPatchResponsesContentApplicationJsonSchemaResult: The result of the database update operation

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Manager` added
  - api tag `gatewayManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gateway_manager/v1/service-groups/:id/patch.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)