---
title: "Update gateway model group"
method: PATCH
path: "/v1/inference-providers/{inferenceProviderId}/model-groups/{groupId}"
tags: ["Inference Providers"]
---

# Update gateway model group

`PATCH /v1/inference-providers/{inferenceProviderId}/model-groups/{groupId}`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/inference-providers/{inferenceProviderId}/model-groups/{groupId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Partially updates a group's name, description, status or model membership. Supplied modelIds replaces membership; omitted modelIds preserves it. IDs must belong to the provider's supported catalog universe. Requires the Manage Gateway providers permission and enabled Gateway management; session callers must recently reauthenticate.

## Path parameters

- `inferenceProviderId` string, typeid, required
- `groupId` string, typeid, required

## Request body

- object
  - `name` string
  - `description` string, nullable
  - `modelIds` string[]
  - `status` 'active' | 'disabled'

## Response `200`

Update gateway model group

- object
  - `modelGroup` object, required
    - `name` string, required
    - `description` string, nullable, required
    - `modelIds` string[], required
    - `status` 'active' | 'disabled', required
    - `id` string, typeid, required: Den TypeID with 'gmg_' prefix and a 26-character base32 suffix.

## Other responses

- `400`: Invalid request or provider configuration.
- `401`: Sign-in required.
- `403`: Access denied or Gateway management disabled.
- `404`: Resource not found.
- `409`: Selection or resource conflict.

## Changes

- **2026-10-23** `c93387179b31`: 1 breaking, 2 info
  - the response property `modelGroup/description` became nullable for the status `200`
  - response property `anyOf[#/components/schemas/InvalidRequestError]/details/items/path/items/` list-of-types was narrowed by removing types `number` from media type `application/json` of response `400`
  - response property `modelGroup/description` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-10-01** `df3754993784`: 1 info
  - added the optional property `anyOf[#/components/schemas/InvalidRequestError]/message` to the response with the `400` status
- **2026-09-11** `d76883ffb5c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/inference-providers/:inferenceProviderId/model-groups/:groupId/patch.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8117bc7c5626?raw)
