From 6cbaff571945826ce68a2f45d31c0fddbef20c05 Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Wed, 23 Oct 2024 08:47:27 -0700
Subject: [PATCH] [OpenAPI] Edit script language and context APIs (#3054)

---
 docs/overlays/elasticsearch-shared-overlays.yaml   |  4 ----
 output/openapi/elasticsearch-openapi.json          | 10 ++++++----
 output/schema/schema.json                          | 14 ++++++++------
 .../get_script_context/GetScriptContextRequest.ts  |  4 ++++
 .../GetScriptLanguagesRequest.ts                   |  4 ++++
 5 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/docs/overlays/elasticsearch-shared-overlays.yaml b/docs/overlays/elasticsearch-shared-overlays.yaml
index 4b40f182f1..91f175d852 100644
--- a/docs/overlays/elasticsearch-shared-overlays.yaml
+++ b/docs/overlays/elasticsearch-shared-overlays.yaml
@@ -167,10 +167,6 @@ actions:
       # S
         - name: script
           x-displayName: Script
-        - name: get_script_context
-          x-displayName: Script - Get contexts
-        - name: get_script_languages
-          x-displayName: Script - Get languages
         - name: search
           x-displayName: Search
         - name: search_application
diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index f0dbb64b5c..dd98777599 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -9042,9 +9042,10 @@
     "/_script_context": {
       "get": {
         "tags": [
-          "get_script_context"
+          "script"
         ],
-        "summary": "Returns all script contexts",
+        "summary": "Get script contexts",
+        "description": "Get a list of supported script contexts and their methods.",
         "operationId": "get-script-context",
         "responses": {
           "200": {
@@ -9074,9 +9075,10 @@
     "/_script_language": {
       "get": {
         "tags": [
-          "get_script_languages"
+          "script"
         ],
-        "summary": "Returns available script types, languages and contexts",
+        "summary": "Get script languages",
+        "description": "Get a list of available script types, languages, and contexts.",
         "operationId": "get-script-languages",
         "responses": {
           "200": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index eb1af79d15..ec566838d6 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -5332,7 +5332,8 @@
           "stability": "stable"
         }
       },
-      "description": "Returns all script contexts.",
+      "description": "Get script contexts.\n\nGet a list of supported script contexts and their methods.",
+      "docTag": "script",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-contexts.html",
       "name": "get_script_context",
       "request": {
@@ -5362,7 +5363,8 @@
           "stability": "stable"
         }
       },
-      "description": "Returns available script types, languages and contexts",
+      "description": "Get script languages.\n\nGet a list of available script types, languages, and contexts.",
+      "docTag": "script",
       "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html",
       "name": "get_script_languages",
       "request": {
@@ -24661,7 +24663,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Returns all script contexts.",
+      "description": "Get script contexts.\n\nGet a list of supported script contexts and their methods.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -24674,7 +24676,7 @@
       },
       "path": [],
       "query": [],
-      "specLocation": "_global/get_script_context/GetScriptContextRequest.ts#L22-L26"
+      "specLocation": "_global/get_script_context/GetScriptContextRequest.ts#L22-L30"
     },
     {
       "kind": "response",
@@ -24746,7 +24748,7 @@
       "body": {
         "kind": "no_body"
       },
-      "description": "Returns available script types, languages and contexts",
+      "description": "Get script languages.\n\nGet a list of available script types, languages, and contexts.",
       "inherits": {
         "type": {
           "name": "RequestBase",
@@ -24759,7 +24761,7 @@
       },
       "path": [],
       "query": [],
-      "specLocation": "_global/get_script_languages/GetScriptLanguagesRequest.ts#L22-L26"
+      "specLocation": "_global/get_script_languages/GetScriptLanguagesRequest.ts#L22-L30"
     },
     {
       "kind": "response",
diff --git a/specification/_global/get_script_context/GetScriptContextRequest.ts b/specification/_global/get_script_context/GetScriptContextRequest.ts
index 6ba1361ed4..69df067f0b 100644
--- a/specification/_global/get_script_context/GetScriptContextRequest.ts
+++ b/specification/_global/get_script_context/GetScriptContextRequest.ts
@@ -20,7 +20,11 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get script contexts.
+ *
+ * Get a list of supported script contexts and their methods.
  * @rest_spec_name get_script_context
  * @availability stack stability=stable
+ * @doc_tag script
  */
 export interface Request extends RequestBase {}
diff --git a/specification/_global/get_script_languages/GetScriptLanguagesRequest.ts b/specification/_global/get_script_languages/GetScriptLanguagesRequest.ts
index 67f459b545..11d3449b4a 100644
--- a/specification/_global/get_script_languages/GetScriptLanguagesRequest.ts
+++ b/specification/_global/get_script_languages/GetScriptLanguagesRequest.ts
@@ -20,7 +20,11 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get script languages.
+ *
+ * Get a list of available script types, languages, and contexts.
  * @rest_spec_name get_script_languages
  * @availability stack stability=stable
+ * @doc_tag script
  */
 export interface Request extends RequestBase {}