[8.6] [DOCS] Create open API specification for run connector (#149274) (

#149614)

# Backport

This will backport the following commits from `main` to `8.6`:
- [[DOCS] Create open API specification for run connector
(#149274)](#149274)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2023-01-26T16:53:47Z","message":"[DOCS]
Create open API specification for run connector
(#149274)","sha":"f78236a2e4c1532a9a135444bea95a0f89d1047e","branchLabelMapping":{"^v8.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:enhancement","Team:ResponseOps","docs","Feature:Actions/ConnectorsManagement","backport:prev-minor","v8.7.0"],"number":149274,"url":"https://github.com/elastic/kibana/pull/149274","mergeCommit":{"message":"[DOCS]
Create open API specification for run connector
(#149274)","sha":"f78236a2e4c1532a9a135444bea95a0f89d1047e"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v8.7.0","labelRegex":"^v8.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/149274","number":149274,"mergeCommit":{"message":"[DOCS]
Create open API specification for run connector
(#149274)","sha":"f78236a2e4c1532a9a135444bea95a0f89d1047e"}}]}]
BACKPORT-->

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

docs/api/actions-and-connectors/execute.asciidoc

@@ -6,6 +6,12 @@
 
 Runs a connector by ID.
 
+[NOTE]
+====
+For the most up-to-date API details, refer to the
+{kib-repo}/tree/{branch}/x-pack/plugins/actions/docs/openapi[open API specification]. For a preview, check out <<connector-apis>>.
+====
+
 [[execute-connector-api-request]]
 === {api-request-title}
 
@@ -362,7 +368,7 @@ on the `subAction` value. This object is not required when `subAction` is
 [%collapsible%open]
 ======
 `comments`:::
-(Optional, array of objects) Additional information that is sent to {sn-sir}.
+(Optional, array of objects) Additional information that is sent to {sn-itsm}.
 +
 .Properties of `comments`
 [%collapsible%open]
@@ -381,7 +387,7 @@ version::::
 =======
 
 `incident`:::
-(Required, object) Information necessary to create or update a {sn-sir} incident.
+(Required, object) Information necessary to create or update a {sn-itsm} incident.
 +
 .Properties of `incident`
 [%collapsible%open]
@@ -520,6 +526,10 @@ to the security incident. The IPs are added as observables to the security incid
 updated. Otherwise, a new incident is created.
 
 `malware_hash`::::
+(Optional, string or array of strings) A list of malware hashes related to the
+security incident. The hashes are added as observables to the security incident.
+
+`malware_url`::::
 (Optional, string or array of strings) A list of malware URLs related to the
 security incident. The URLs are added as observables to the security incident.