move discovery api

Author: hahnbeelee

advanced/discovery-api/overview.mdx

@@ -1,13 +1,10 @@
 ---
-title: Introduction
+title: Overview
 ---
 
-<Check>
-  The Mintlify REST API is only available on the [Pro plan and
-  above](https://mintlify.com/pricing).
-</Check>
+## Trigger Updates
 
-Leverage the external API to programmatically trigger an update when desired.
+Leverage the REST API to programmatically trigger an update when desired.
 The primary use-case will be to trigger updates. We will be adding more and more
 functionality to the API overtime. Let us know what else you want to see in
 [our community](https://mintlify.com/community)!
@@ -21,3 +18,28 @@ associated with the entire org and can be used across multiple deployments.
 <Frame>
   <img src="/images/external-api-key.png" />
 </Frame>
+
+## Discovery API
+
+The Discovery API allows you to embed an AI chat experience grounded in your docs and continually kept up to date into any application of your choosing.
+Responses include citations so you can point your users to the right places they need to get help.
+
+## Getting Started
+
+To get started, you'll need to generate a Discovery API key in the [dashboard](https://dashboard.mintlify.com/products/chat/widget):
+
+<Frame>
+  <img
+    alt="Create a Discovery API key"
+    src="/images/generate-discovery-api-key.png"
+  />
+</Frame>
+
+<Note>
+  The Discovery API token is a public token that can be referenced in your
+  frontend code whereas the API key is a server-side token that should be kept
+  secret.
+</Note>
+
+Now that you have an API key, check out our [example](https://github.com/mintlify/discovery-api-example) for how to use
+the API for AI chat. You can also see a deployed version of this example at [chat.mintlify.com](https://chat.mintlify.com).

advanced/discovery-api/create-topic.mdx renamed to advanced/rest-api/discovery/create-topic.mdx

@@ -1,4 +1,3 @@
 ---
 openapi: "GET /project/update-status/{statusId}"
-hideApiMarker: true
 ---

advanced/discovery-api/generate-message.mdx renamed to advanced/rest-api/discovery/generate-message.mdx

@@ -1,4 +1,3 @@
 ---
 openapi: "POST /project/update/{projectId}"
-hideApiMarker: true
 ---

advanced/rest-api/overview.mdx

@@ -182,17 +182,20 @@
           "group": "REST API",
           "pages": [
             "advanced/rest-api/overview",
-            "advanced/rest-api/trigger-update",
-            "advanced/rest-api/update-status"
-          ]
-        },
-        {
-          "icon": "magnifying-glass",
-          "group": "Discovery API",
-          "pages": [
-            "advanced/discovery-api/overview",
-            "advanced/discovery-api/create-topic",
-            "advanced/discovery-api/generate-message"
+            {
+              "group": "Updates",
+              "pages": [
+                "advanced/rest-api/update/trigger",
+                "advanced/rest-api/update/status"
+              ]
+            },
+            {
+              "group": "Discovery API",
+              "pages": [
+                "advanced/rest-api/discovery/create-topic",
+                "advanced/rest-api/discovery/generate-message"
+              ]
+            }
           ]
         }
       ]