From 34100d290bcee608b06a5bae3b942362422321d1 Mon Sep 17 00:00:00 2001
From: tonykipkemboi <iamtonykipkemboi@gmail.com>
Date: Wed, 20 Aug 2025 11:13:05 -0400
Subject: [PATCH] docs(mintlify): add explicit endpoint MDX pages and include
 in nav; keep OpenAPI auto-gen as fallback

---
 docs/docs.json                    | 7 ++++++-
 docs/en/api-reference/inputs.mdx  | 7 +++++++
 docs/en/api-reference/kickoff.mdx | 7 +++++++
 docs/en/api-reference/status.mdx  | 7 +++++++
 4 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 docs/en/api-reference/inputs.mdx
 create mode 100644 docs/en/api-reference/kickoff.mdx
 create mode 100644 docs/en/api-reference/status.mdx

diff --git a/docs/docs.json b/docs/docs.json
index 2d549948d..6a39ec170 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -341,7 +341,12 @@
             "groups": [
               {
                 "group": "Getting Started",
-                "pages": ["en/api-reference/introduction"]
+                "pages": [
+                  "en/api-reference/introduction",
+                  "en/api-reference/inputs",
+                  "en/api-reference/kickoff",
+                  "en/api-reference/status"
+                ]
               },
               {
                 "group": "Endpoints",
diff --git a/docs/en/api-reference/inputs.mdx b/docs/en/api-reference/inputs.mdx
new file mode 100644
index 000000000..0f177e5ad
--- /dev/null
+++ b/docs/en/api-reference/inputs.mdx
@@ -0,0 +1,7 @@
+---
+title: "GET /inputs"
+description: "Get required inputs for your crew"
+openapi: "/enterprise-api.en.yaml GET /inputs"
+---
+
+
diff --git a/docs/en/api-reference/kickoff.mdx b/docs/en/api-reference/kickoff.mdx
new file mode 100644
index 000000000..1a879f7df
--- /dev/null
+++ b/docs/en/api-reference/kickoff.mdx
@@ -0,0 +1,7 @@
+---
+title: "POST /kickoff"
+description: "Start a crew execution"
+openapi: "/enterprise-api.en.yaml POST /kickoff"
+---
+
+
diff --git a/docs/en/api-reference/status.mdx b/docs/en/api-reference/status.mdx
new file mode 100644
index 000000000..a07894346
--- /dev/null
+++ b/docs/en/api-reference/status.mdx
@@ -0,0 +1,7 @@
+---
+title: "GET /status/{kickoff_id}"
+description: "Get execution status"
+openapi: "/enterprise-api.en.yaml GET /status/{kickoff_id}"
+---
+
+