diff --git a/docs/api/cases/cases-api-create.asciidoc b/docs/api/cases/cases-api-create.asciidoc
index c5d74293af185..459e4be182139 100644
--- a/docs/api/cases/cases-api-create.asciidoc
+++ b/docs/api/cases/cases-api-create.asciidoc
@@ -40,7 +40,7 @@ individual field, specify `null` as its value.
 For {sn-itsm} connectors, refer to <<servicenow-action-configuration>>. For
 example:
 
-* `urgency`: The extent to which the incident resolution can delay.
+* `urgency`: The extent to which the incident resolution can be delayed.
 * `severity`: The severity of the incident.
 * `impact`: The effect an incident had on business.
 * `category`: The category of the incident.
@@ -205,5 +205,5 @@ the case identifier, version, and creation time. For example:
 <1> The case identifier is also its saved object ID (`savedObjectId`), which is
 used when pushing cases to external systems.
 <2> The default connector used to push cases to external services.
-<3> The `external_service` object stores information when the case is pushed to
-external systems.
\ No newline at end of file
+<3> The `external_service` object stores information about the incident after it
+is pushed to an external incident management system.
\ No newline at end of file
diff --git a/docs/api/cases/cases-api-update.asciidoc b/docs/api/cases/cases-api-update.asciidoc
index 6f9cb3f68f769..261cea77517dd 100644
--- a/docs/api/cases/cases-api-update.asciidoc
+++ b/docs/api/cases/cases-api-update.asciidoc
@@ -46,9 +46,9 @@ field, specify `null` as its value.
 For {sn-itsm} connectors, refer to <<servicenow-action-configuration>>. For
 example:
 
-* `urgency`: The urgency of the incident.
+* `urgency`: The extent to which the incident resolution can be delayed.
 * `severity`: The severity of the incident.
-* `impact`: The impact of the incident.
+* `impact`: The effect an incident had on business.
 * `category`: The category of the incident.
 * `subcategory`: The subcategory of the incident.
 
@@ -146,6 +146,8 @@ PATCH api/cases
 {
   "cases": [
     {
+      "id": "a18b38a0-71b0-11ea-a0b2-c51ea50a58e2",
+      "version": "WzIzLDFd",
       "connector": {
         "id": "131d4448-abe0-4789-939d-8ef60680b498",
         "name": "My connector",
@@ -156,7 +158,6 @@ PATCH api/cases
           "parent": null
         }
       },
-      "id": "a18b38a0-71b0-11ea-a0b2-c51ea50a58e2",
       "description": "James Bond clicked on a highly suspicious email
       banner advertising cheap holidays for underpaid civil servants.
       Operation bubblegum is active. Repeat - operation bubblegum is
@@ -168,8 +169,7 @@ PATCH api/cases
       ],
       "settings": {
         "syncAlerts": true
-      },
-      "version": "WzIzLDFd"
+      }
     }
   ]
 }