---
title: "Changes to Update Team Group Mappings"
method: PATCH
path: "/v3/portals/{portalId}/identity-provider/team-group-mappings"
---

# Changes to Update Team Group Mappings

`PATCH /v3/portals/{portalId}/identity-provider/team-group-mappings`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
- **2026-09-25** `68d43091b84d`: 2 warning
- **2026-09-18** `f324fb7610e4`: 2 breaking, 18 info
- **2025-10-30** `845120e19d45`: 3 breaking
- **2025-10-23** `8ab3ec3ed301`: 1 warning
- **2025-08-22** `3c0154b2053a`: 12 breaking, 3 info
- **2025-07-01** `9a3d26a00088`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-25** `68d43091b84d`: 2 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
- **2026-09-18** `f324fb7610e4`: 2 breaking, 18 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - added the required property `instance` to the response with the `400` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `403` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `403` status
- **2025-10-30** `845120e19d45`: 3 breaking
  - the request property `data` became not nullable
  - the request property `data/items/groups` became not nullable
  - the request property `data/items/team_id` became not nullable
- **2025-10-23** `8ab3ec3ed301`: 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `3c0154b2053a`: 12 breaking, 3 info
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/source` became nullable for the status `400`
  - the response property `data` became nullable for the status `200`
  - the response property `data/items/groups` became nullable for the status `200`
  - the response property `data/items/team_id` became nullable for the status `200`
  - the response property `detail` became nullable for the status `401`
  - the response property `instance` became nullable for the status `401`
  - the response property `status` became nullable for the status `401`
  - the response property `title` became nullable for the status `401`
  - the request property `data` became nullable
  - the request property `data/items/groups` became nullable
  - the request property `data/items/team_id` became nullable
- **2025-07-01** `9a3d26a00088`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v3/portals/:portalId/identity-provider/team-group-mappings/patch.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/:portalId/identity-provider/team-group-mappings/patch)