diff --git a/openapi/v2023.8.2/bundled.yaml b/openapi/v2023.8.2/bundled.yaml
index df55f2c..ed97ddc 100644
--- a/openapi/v2023.8.2/bundled.yaml
+++ b/openapi/v2023.8.2/bundled.yaml
@@ -395,7 +395,6 @@ components:
       description: A policy governs data and Agreement in the realm of an organisation that is refered to as "data controller" (GDPR) and owner of referencing Agreements.
       x-not-in-database: false
       required:
-        - id
         - name
         - version
         - url
@@ -414,7 +413,7 @@ components:
           type: string
           format: ''
           example: ''
-          description: Version of the policy
+          description: Version of the policy. It can follow semver format.
         url:
           type: string
           format: ''
@@ -471,6 +470,10 @@ components:
           format: ''
           example: ''
           description: This was previously called "schema" but for technical reasons should be called "schemaName"
+          enum:
+            - dataAgreement
+            - policy
+            - dataAgreementRecord
         objectId:
           type: string
           format: ''
@@ -485,7 +488,7 @@ components:
           type: string
           format: ''
           example: ''
-          description: 'Revisioned data (serialized as JSON) as a dict {objectData: {...}, schemaName: ..., objectId: ..., signedWithoutObjectId: ..., timestamp: ..., authorizedByIndividual: ..., authorizedByOther: ...}. It contains all the fields of the schema except id, successor, predecessorHash and predecessorSignature.'
+          description: 'Revisioned data (serialized as JSON) as a dict.Apply JSON Canonicalization Scheme as per IETF RFC 8785. It contains all the fields of the schema except id, successor, predecessorHash and predecessorSignature.'
         serializedHash:
           type: string
           format: ''
@@ -495,20 +498,18 @@ components:
           type: string
           format: ''
           example: ''
-          description: Timestamp of when revisioning happened
-        authorizedByIndividual:
-          $ref: '#/components/schemas/Individual'
-          x-fk-model: Individual
-          description: ''
+          description: Timestamp of when revisioning happened. It should be ISO 8601 UTC date time
+        authorizedByIndividualId:
+          description: Individual Id
         authorizedByOther:
           type: string
           format: ''
           example: ''
           description: Reference to an admin user that has created this revision
-        successor:
-          $ref: '#/components/schemas/Revision'
+        successorId:
           x-fk-model: Revision
-          description: 'This revision is no longer the latest revision, refer to its successor.'
+          type: string
+          description: 'If this revision is no longer the latest revision, refer to its successor.'
         predecessorHash:
           type: string
           format: ''
diff --git a/openapi/v2023.8.2/definitions/Policy.yaml b/openapi/v2023.8.2/definitions/Policy.yaml
index 9c4abf7..580d1f2 100644
--- a/openapi/v2023.8.2/definitions/Policy.yaml
+++ b/openapi/v2023.8.2/definitions/Policy.yaml
@@ -4,7 +4,6 @@ description: 'A policy governs data and Agreement in the realm of an organisatio
 x-not-in-database: false
 
 required:
-  - id
   - name
   - version
   - url
@@ -25,7 +24,7 @@ properties:
     type: string
     format: ""
     example: ""
-    description: "Version of the policy"
+    description: "Version of the policy. It can follow semver format."
 
   url:
     type: string
diff --git a/openapi/v2023.8.2/definitions/Revision.yaml b/openapi/v2023.8.2/definitions/Revision.yaml
index d461a6e..47095c6 100644
--- a/openapi/v2023.8.2/definitions/Revision.yaml
+++ b/openapi/v2023.8.2/definitions/Revision.yaml
@@ -22,6 +22,10 @@ properties:
     format: ""
     example: ""
     description: 'This was previously called "schema" but for technical reasons should be called "schemaName"'
+    enum:
+      - dataAgreement
+      - policy
+      - dataAgreementRecord
 
   objectId:
     type: string
@@ -39,7 +43,7 @@ properties:
     type: string
     format: ""
     example: ""
-    description: "Revisioned data (serialized as JSON) as a dict {objectData: {...}, schemaName: ..., objectId: ..., signedWithoutObjectId: ..., timestamp: ..., authorizedByIndividual: ..., authorizedByOther: ...}. It contains all the fields of the schema except id, successor, predecessorHash and predecessorSignature."
+    description: "Revisioned data (serialized as JSON) as a dict.Apply JSON Canonicalization Scheme as per IETF RFC 8785. It contains all the fields of the schema except id, successor, predecessorHash and predecessorSignature."
 
   serializedHash:
     type: string
@@ -51,12 +55,10 @@ properties:
     type: string
     format: ""
     example: ""
-    description: "Timestamp of when revisioning happened"
+    description: "Timestamp of when revisioning happened. It should be ISO 8601 UTC date time"
 
-  authorizedByIndividual:
-    $ref: "./Individual.yaml"
-    x-fk-model: "Individual"
-    description: ""
+  authorizedByIndividualId:
+    description: "Individual Id"
 
   authorizedByOther:
     type: string
@@ -64,10 +66,10 @@ properties:
     example: ""
     description: "Reference to an admin user that has created this revision"
 
-  successor:
-    $ref: "./Revision.yaml"
+  successorId:
     x-fk-model: "Revision"
-    description: "This revision is no longer the latest revision, refer to its successor."
+    type: string
+    description: "If this revision is no longer the latest revision, refer to its successor."
 
   predecessorHash:
     type: string