Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/examples/CustomObjects/CustomObjectReference.json

@@ -0,0 +1,4 @@
+{
+  "id": "4e2b758f-f259-4c14-808e-2beb126bc0f1",
+  "typeId": "key-value-document"
+}

api-specs/api/resources/custom-objects.raml

@@ -51,7 +51,7 @@ post:
     If an object with the given container/key exists, the object will be replaced with the new value and the version is incremented.
     If the request contains a version and an object with the given container/key, then the version must match the version of the existing object. Concurrent updates to the same Custom Object returns a [ConcurrentModification](ctp:api:type:ConcurrentModificationError) error even if the version is not provided.
 
-    Fields with `null` values will **not be saved**.
+    Fields within `value` that have `null` values **are not saved**.
   body:
     application/json:
       example: !include ../examples/custom-object-create.example.json
@@ -61,7 +61,7 @@ post:
       required: false
       description: |
         Expands a `value` of type [Reference](ctp:api:type:Reference).
-        In case the referenced object does not exist, the API returns the non-expanded reference.
+        If the referenced object does not exist, the API returns the non-expanded reference.
   responses:
     200:
       body:
@@ -99,7 +99,7 @@ post:
         required: false
         description: |
           Expands a `value` of type [Reference](ctp:api:type:Reference).
-          In case the referenced object does not exist, the API returns the non-expanded reference.
+          If the referenced object does not exist, the API returns the non-expanded reference.
     responses:
       200:
         body:
@@ -126,7 +126,7 @@ post:
         required: false
         description: |
           Expands a `value` of type [Reference](ctp:api:type:Reference).
-          In case the referenced object does not exist, the API returns the non-expanded reference.
+          If the referenced object does not exist, the API returns the non-expanded reference.
     responses:
       200:
         body:
@@ -162,14 +162,14 @@ post:
         required: false
         description: |
           `id`, `key`, `version`, `createdAt`, and `lastModifiedAt` can be used as predicate.
-          The `field` value can also be used as predicate but is not checked for validity.
-          For example, you can use any predicates: `value(aValue=true)` or `value(myObject(myValue="abc"))`.
+          `value` can also be used as predicate, but is not checked for validity.
+          For example: `value(exampleNumber > 1233)` or `value(exampleObject(exampleBoolean = true))`.
       expand:
         type: Expansion[]
         required: false
         description: |
           Expands a `value` of type [Reference](ctp:api:type:Reference).
-          In case the referenced object does not exist, the API returns the non-expanded reference.
+          If the referenced object does not exist, the API returns the non-expanded reference.
     responses:
       200:
         body:

api-specs/api/types/custom-object/CustomObject.raml

@@ -46,6 +46,6 @@ properties:
   value:
     type: any
     description: |
-      JSON standard types Number, String, Boolean, Array, Object, and [common API data types](/../api/types).
-      For values of type [Reference](ctp:api:type:Reference) the integrity of the data is not guaranteed.
-      If the referenced object is deleted, the API does not delete the corresponding reference to it and the `value` points to a non-existing object in such case.
+      Can be any JSON standard type, such as number, string, boolean, array, object, or a [common API data type](/../api/types).
+
+      - For values of type [Reference](ctp:api:type:Reference) the integrity of the data is not guaranteed. If the referenced object is deleted, the API does not delete the corresponding reference to it and the `value` points to a non-existing object in such case.

api-specs/api/types/custom-object/CustomObjectDraft.raml

@@ -19,9 +19,10 @@ properties:
   value:
     type: any
     description: |
-      JSON standard types Number, String, Boolean, Array, Object, and [common API data types](/../api/types).
-      For values of type [Reference](ctp:api:type:Reference) the integrity of the data is not guaranteed.
-      If the referenced object is deleted, the API does not delete the corresponding reference to it and the `value` points to a non-existing object in such case.
+      Can be any JSON standard type, such as number, string, boolean, array, object, or a [common API data type](/../api/types).
+
+      - Fields within `value` that have `null` values **are not saved**.
+      - For values of type [Reference](ctp:api:type:Reference) the integrity of the data is not guaranteed. If the referenced object is deleted, the API does not delete the corresponding reference to it and the `value` points to a non-existing object in such case.
   version?:
     type: number
     format: int64

api-specs/api/types/custom-object/CustomObjectReference.raml

@@ -2,6 +2,7 @@
 (package): CustomObject
 type: Reference
 displayName: CustomObjectReference
+example: !include ../../examples/CustomObjects/CustomObjectReference.json
 discriminatorValue: key-value-document
 description: |
   [Reference](ctp:api:type:Reference) to a [CustomObject](ctp:api:type:CustomObject).