From f1ade670bfb721c6b506022594fbb3ab1161f50a Mon Sep 17 00:00:00 2001
From: BimsaraBodaragama <bodaragamadb.office@gmail.com>
Date: Sat, 18 Oct 2025 03:53:15 +0530
Subject: [PATCH 1/2] [Asgardeo Docs] Add behavioral change notice for omitting
 null fields in DCR API response

---
 en/asgardeo/docs/apis/restapis/oauth-dcr.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml b/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
index d3a0bc4a10..2d3f2983ec 100644
--- a/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
+++ b/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
@@ -3,6 +3,15 @@ info:
   title: Asgardeo - OAuth2 Dynamic Client Registration API
   description: |
     This document specifies an OAuth2 Dynamic Client Registration endpoint for Asgardeo.
+    <div style="border: 1px solid #f4c542; border-left: 6px solid #f4c542; border-radius: 6px; overflow: hidden; margin: 16px 0; background-color: #fffaf0;">
+      <div style="background-color: #fff8e5; padding: 10px 14px; border-bottom: 1px solid #f4c542;">
+        <span style="font-weight: 600; color: #8a6d00; font-size: 15px;">⚠️ NOTE</span>
+      </div>
+      <div style="padding: 14px 16px; color: #1a1a1a; line-height: 1.6;">
+        As part of an upcoming behavioral change, <code>null</code> fields will be omitted from the DCR API response to align with REST best practices.<br><br>
+        The current behavior of returning <code>null</code> fields will remain temporarily enabled until <b>May&nbsp;1,&nbsp;2026</b>, providing a grace period for users to adapt.
+      </div>
+    </div>
   version: 1.1.0
 servers:
 - url: https:/api.asgardeo.io/t/{org-name}/api/identity/oauth2/dcr/v1.1

From cf4544f51a34a2b7e239a60175851137c1327599 Mon Sep 17 00:00:00 2001
From: BimsaraBodaragama <bodaragamadb.office@gmail.com>
Date: Mon, 20 Oct 2025 11:27:05 +0530
Subject: [PATCH 2/2] Refine DCR API note to emphasize upcoming change as
 suggested.

---
 en/asgardeo/docs/apis/restapis/oauth-dcr.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml b/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
index 2d3f2983ec..86d1082cd7 100644
--- a/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
+++ b/en/asgardeo/docs/apis/restapis/oauth-dcr.yaml
@@ -8,8 +8,8 @@ info:
         <span style="font-weight: 600; color: #8a6d00; font-size: 15px;">⚠️ NOTE</span>
       </div>
       <div style="padding: 14px 16px; color: #1a1a1a; line-height: 1.6;">
-        As part of an upcoming behavioral change, <code>null</code> fields will be omitted from the DCR API response to align with REST best practices.<br><br>
-        The current behavior of returning <code>null</code> fields will remain temporarily enabled until <b>May&nbsp;1,&nbsp;2026</b>, providing a grace period for users to adapt.
+        Starting <b>May&nbsp;1,&nbsp;2026</b>, <code>null</code> fields will no longer appear in the DCR API response to align with REST best practices.
+        We recommend using this grace period to update your integrations and ensure continued functionality.
       </div>
     </div>
   version: 1.1.0