diff --git a/openapi/v2023.11.1/bundled.yaml b/openapi/v2023.11.1/bundled.yaml
index 4500218..111823c 100644
--- a/openapi/v2023.11.1/bundled.yaml
+++ b/openapi/v2023.11.1/bundled.yaml
@@ -824,7 +824,10 @@ openapi: 3.1.0
 paths:
   /config/data-agreement:
     post:
-      description: CREATE - Create a new data agreement and returned together with revision
+      summary: CREATE - Create a data agreement
+      description: |
+        This endpoint creates a data agreement for an organisation. 
+        It also returns the latest revision of the created data agreement.
       operationId: configCreateAgreement
       parameters: []
       requestBody:
@@ -854,7 +857,6 @@ paths:
           description: bad input parameter
       security:
         - BearerAuth: []
-      summary: CREATE - Create data agreement
       tags:
         - config
       x-specification-crudl-model: DataAgreement
diff --git a/openapi/v2023.11.1/paths/configCreateAgreement.yaml b/openapi/v2023.11.1/paths/configCreateAgreement.yaml
index 9b63097..f477d39 100644
--- a/openapi/v2023.11.1/paths/configCreateAgreement.yaml
+++ b/openapi/v2023.11.1/paths/configCreateAgreement.yaml
@@ -1,4 +1,7 @@
-description: CREATE - Create a new data agreement and returned together with revision
+summary: CREATE - Create a data agreement
+description: |
+  This endpoint creates a data agreement for an organisation. 
+  It also returns the latest revision of the created data agreement.
 operationId: configCreateAgreement
 parameters: []
 requestBody:
@@ -28,7 +31,6 @@ responses:
     description: bad input parameter
 security:
   - BearerAuth: []
-summary: CREATE - Create data agreement
 tags:
   - config
 x-specification-crudl-model: DataAgreement