From 1f0c2f6997b2a2427fa3ac695fe22b97d821d1ca Mon Sep 17 00:00:00 2001 From: openhands Date: Sun, 4 Oct 2026 12:46:14 +0000 Subject: [PATCH 1/2] docs: serve api-catalog by enabling download-spec The docs site advertises ; rel="api-catalog" in its Link header, but that path returns 404 because no OpenAPI download is configured. Adding "download-spec" to contextual.options makes Mintlify publish the RFC 9727 linkset at /.well-known/api-catalog, linking each OpenAPI spec declared in docs.json (including the OpenHands Cloud spec) so agents can discover the API. Co-authored-by: openhands --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index b4554cfe..fc309833 100644 --- a/docs.json +++ b/docs.json @@ -702,6 +702,7 @@ "options": [ "copy", "view", + "download-spec", "chatgpt", "claude" ] From 207d49a8e1a473895249305f44f817a60776efb9 Mon Sep 17 00:00:00 2001 From: enyst Date: Sun, 4 Oct 2026 17:17:58 +0000 Subject: [PATCH 2/2] docs: exclude legacy V0 spec from api-catalog The legacy V0_openapi.json is unreferenced in docs.json but Mintlify auto-uploads every OpenAPI spec in the repo, so enabling download-spec advertised it in the /.well-known/api-catalog linkset alongside the two current specs. Add a .mintignore entry to exclude it from publishing. Co-authored-by: openhands --- .mintignore | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .mintignore diff --git a/.mintignore b/.mintignore new file mode 100644 index 00000000..84558c9b --- /dev/null +++ b/.mintignore @@ -0,0 +1,5 @@ +# Legacy OpenHands V0 REST API schema. Superseded by the Cloud schema +# (openapi/openhands-cloud.json) and kept only for historical reference. +# Excluded so it is not published, indexed, or advertised in the +# /.well-known/api-catalog linkset. +openapi/V0_openapi.json