---
title: "Changes to Enable or Disable Domain"
method: PATCH
path: "/v3/portals/{portalId}/custom-domain"
---

# Changes to Enable or Disable Domain

`PATCH /v3/portals/{portalId}/custom-domain`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 30 revisions.

- **2025-11-06** `5d2b35832e3f` — 1 warning
- **2025-10-02** `ecce2daf9de6` — 5 breaking, 5 info
- **2025-08-12** `b2800570b3e2` — 2 warning, 1 info
- **2025-04-22** `0f6e0fa4241c` — 1 warning, 4 info

## Changes

- **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, 5 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`
  - added the new optional request property `ssl/skip_ca_check`
  - the request property `enabled` became nullable
  - the request property `ssl/custom_certificate` became nullable
  - the request property `ssl/custom_private_key` became nullable
  - added the optional property `ssl/skip_ca_check` to the response with the `200` status
- **2025-08-12** `b2800570b3e2` — 2 warning, 1 info
  - removed the request property `custom_certificate`
  - removed the request property `custom_private_key`
  - added the new optional request property `ssl`
- **2025-04-22** `0f6e0fa4241c` — 1 warning, 4 info
  - added the new `custom_certificate` enum value to the `ssl/domain_verification_method` response property for the response status `200`
  - added the new optional request property `custom_certificate`
  - added the new optional request property `custom_private_key`
  - added the optional property `ssl/expires_at` to the response with the `200` status
  - added the optional property `ssl/uploaded_at` to the response with the `200` status

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v3/portals/:portalId/custom-domain/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/custom-domain/patch)
