---
title: "Changes to Update Portal"
method: PATCH
path: "/v3/portals/{portalId}"
---

# Changes to Update Portal

`PATCH /v3/portals/{portalId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 30 revisions.

- **2026-08-18** `658ffb748f95` — 2 warning, 2 info
- **2026-06-22** `5536690850b5` — 2 info
- **2026-06-11** `be4c4e09af62` — 2 info
- **2026-05-20** `55d91b8ceecd` — 2 info
- **2026-02-16** `106b373707f3` — 2 info
- **2025-11-06** `5d2b35832e3f` — 1 warning
- **2025-10-02** `ecce2daf9de6` — 5 breaking, 9 info
- **2025-04-28** `d12b4edfb67b` — 2 breaking, 1 warning, 28 info

## Changes

- **2026-08-18** `658ffb748f95` — 2 warning, 2 info
  - removed the request property `mcp_server_enabled`
  - removed the optional property `mcp_server_enabled` from the response with the `200` status
  - added the new optional request property `ai`
  - added the optional property `ai` to the response with the `200` status
- **2026-06-22** `5536690850b5` — 2 info
  - added the new optional request property `mcp_server_enabled`
  - added the optional property `mcp_server_enabled` to the response with the `200` status
- **2026-06-11** `be4c4e09af62` — 2 info
  - added the new optional request property `notifications_developer_pii_visibility_enabled`
  - added the optional property `notifications_developer_pii_visibility_enabled` to the response with the `200` status
- **2026-05-20** `55d91b8ceecd` — 2 info
  - the `sipr_enabled` request property default value `false` was added
  - the `sipr_enabled` response's property default value `false` was added for the status `200`
- **2026-02-16** `106b373707f3` — 2 info
  - added the new optional request property `sipr_enabled`
  - added the required property `sipr_enabled` to the response with the `200` status
- **2025-11-06** `5d2b35832e3f` — 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-10-02** `ecce2daf9de6` — 5 breaking, 9 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 request property `name` became nullable
  - the `authentication_enabled` request property default value `true` was added
  - the `auto_approve_applications` request property default value `false` was added
  - the `auto_approve_developers` request property default value `false` was added
  - the `rbac_enabled` request property default value `false` was added
  - the `authentication_enabled` response's property default value `true` was added for the status `200`
  - the `auto_approve_applications` response's property default value `false` was added for the status `200`
  - the `auto_approve_developers` response's property default value `false` was added for the status `200`
  - the `rbac_enabled` response's property default value `false` was added for the status `200`
- **2025-04-28** `d12b4edfb67b` — 2 breaking, 1 warning, 28 info
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/Portal, subschema #2` from the request body `allOf` list
  - added the new optional request property `authentication_enabled`
  - added the new optional request property `auto_approve_applications`
  - added the new optional request property `auto_approve_developers`
  - added the new optional request property `default_api_visibility`
  - added the new optional request property `default_application_auth_strategy_id`
  - added the new optional request property `default_page_visibility`
  - added the new optional request property `description`
  - added the new optional request property `display_name`
  - added the new optional request property `labels`
  - added the new optional request property `name`
  - added the new optional request property `rbac_enabled`
  - removed `#/components/schemas/Portal, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `labels` to the response with the `200` status
  - added the required property `authentication_enabled` to the response with the `200` status
  - added the required property `auto_approve_applications` to the response with the `200` status
  - added the required property `auto_approve_developers` to the response with the `200` status
  - added the required property `canonical_domain` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `default_api_visibility` to the response with the `200` status
  - added the required property `default_application_auth_strategy_id` to the response with the `200` status
  - added the required property `default_domain` to the response with the `200` status
  - added the required property `default_page_visibility` to the response with the `200` status
  - added the required property `description` to the response with the `200` status
  - added the required property `display_name` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `rbac_enabled` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v3/portals/:portalId/patch.md) · [API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v3/portals/:portalId/patch)