diff --git a/.apigentools-info b/.apigentools-info
index b3df5d15927..8f60ae67547 100644
--- a/.apigentools-info
+++ b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-18 14:10:19.119214",
-            "spec_repo_commit": "d1f49008"
+            "regenerated": "2024-12-18 16:21:27.746834",
+            "spec_repo_commit": "e12aeab9"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-12-18 14:10:19.134937",
-            "spec_repo_commit": "d1f49008"
+            "regenerated": "2024-12-18 16:21:27.761718",
+            "spec_repo_commit": "e12aeab9"
         }
     }
 }
\ No newline at end of file
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index c19d456f413..dc4ea550c3e 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -46837,7 +46837,11 @@ tags:
     page](https://docs.datadoghq.com/account_management/org_settings/service_accounts/)
     for more information.
   name: Service Accounts
-- description: API to create, update, retrieve and delete service definitions.
+- description: 'API to create, update, retrieve and delete service definitions.
+
+    Note: Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/service_definitions/v3-0/)
+    has new API endpoints documented under [Software Catalog](https://docs.datadoghq.com/api/latest/software-catalog/).
+    Use the following Service Definition endpoints for v2.2 and earlier.'
   externalDocs:
     url: https://docs.datadoghq.com/tracing/service_catalog/
   name: Service Definition
diff --git a/src/test/resources/com/datadog/api/client/v2/api/service_definition.feature b/src/test/resources/com/datadog/api/client/v2/api/service_definition.feature
index 5c74a74b367..20c94280874 100644
--- a/src/test/resources/com/datadog/api/client/v2/api/service_definition.feature
+++ b/src/test/resources/com/datadog/api/client/v2/api/service_definition.feature
@@ -1,6 +1,10 @@
 @endpoint(service-definition) @endpoint(service-definition-v2)
 Feature: Service Definition
-  API to create, update, retrieve and delete service definitions.
+  API to create, update, retrieve and delete service definitions. Note:
+  Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/s
+  ervice_definitions/v3-0/) has new API endpoints documented under [Software
+  Catalog](https://docs.datadoghq.com/api/latest/software-catalog/). Use the
+  following Service Definition endpoints for v2.2 and earlier.
 
   Background:
     Given a valid "apiKeyAuth" key in the system