Add example for start trial

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -402,4 +402,14 @@ actions:
             application/json:
               examples:
                 getLicenseResponseExample1:
-                  $ref: "../../specification/license/get_trial_status/GetTrialLicenseStatusResponseExample1.yaml"
+                  $ref: "../../specification/license/get_trial_status/GetTrialLicenseStatusResponseExample1.yaml"
+  - target: "$.paths['/_license/start_trial']['post']"
+    description: "Add example for start trial response"
+    update: 
+      responses:
+        200:
+          content:
+            application/json:
+              examples:
+                startTrialLicenseResponseExample1:
+                  $ref: "../../specification/license/post_start_trial/StartTrialLicenseResponseExample1.yaml"

output/schema/schema.json

@@ -30,6 +30,7 @@ import { RequestBase } from '@_types/Base'
  * @rest_spec_name license.post_start_trial
  * @availability stack since=6.1.0 stability=stable
  * @cluster_privileges manage
+ * @doc_id start-trial
  */
 export interface Request extends RequestBase {
   query_parameters: {

specification/license/post/licensingUpdateLicenseRequestExample1.yaml renamed to specification/license/post/PostLicenseRequestExample1.yaml

@@ -0,0 +1,7 @@
+# summary:
+description: A successful response from `POST /_license/start_trial?acknowledge=true`.
+# type: response
+# response_code: ''
+value:
+  trial_was_started: true
+  acknowledged: true