Add registry API reference (#372)

* Add registry API reference
* Update registry API URL and add sorting options
* Add links into registry reference

---------

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
Co-authored-by: Dan Barr <6922515+danbarr@users.noreply.github.com>

Author: danbarr

docs/toolhive/guides-registry/authentication.mdx

@@ -281,7 +281,9 @@ regardless of the auth mode:
 - `/.well-known/*` - OAuth discovery endpoints (RFC 9728)
 
 You can configure additional public paths using the `publicPaths` field in your
-OAuth configuration.
+OAuth configuration. See the
+[Registry API reference](../reference/registry-api.mdx) for complete endpoint
+documentation.
 
 ## RFC 9728 OAuth discovery
 

docs/toolhive/guides-registry/configuration.mdx

@@ -190,6 +190,9 @@ registries:
   versions
 - `GET` operations for listing and retrieving servers
 
+See the [Registry API reference](../reference/registry-api.mdx) for complete
+endpoint documentation and request/response examples.
+
 ### Kubernetes registry
 
 Discovers MCP servers from running Kubernetes deployments. Automatically creates

docs/toolhive/guides-registry/intro.mdx

@@ -101,3 +101,5 @@ The server supports five registry source types:
 
 - [Configure registry sources](./configuration.mdx) to set up your registry
 - [Deploy the server](./deployment.mdx) in your environment
+- [View the API reference](../reference/registry-api.mdx) for endpoint
+  documentation

docs/toolhive/reference/registry-api.mdx

@@ -0,0 +1,9 @@
+---
+title: Registry API reference
+description: Reference documentation for the ToolHive Registry Server REST API
+hide_table_of_contents: true
+---
+
+import ApiDocMdx from '@theme/ApiDocMdx';
+
+<ApiDocMdx id='toolhive-registry-api' />

docusaurus.config.ts

@@ -114,10 +114,19 @@ const config: Config = {
             normalizeUrl: false,
             config: path.join(__dirname, 'src/redocly/redocly-toolhive.yaml'),
           },
+          {
+            id: 'toolhive-registry-api',
+            spec: 'https://cdn.jsdelivr.net/gh/stacklok/toolhive-registry-server@latest/docs/thv-registry-api/swagger.yaml',
+            config: path.join(__dirname, 'src/redocly/redocly-toolhive.yaml'),
+          },
         ],
         theme: {
           primaryColor: '#2809a5',
           primaryColorDark: '#7ab7ff',
+          options: {
+            sortTagsAlphabetically: true,
+            sortOperationsAlphabetically: true,
+          },
         },
       },
     ],
@@ -202,13 +211,17 @@ const config: Config = {
               label: 'ToolHive API',
               to: 'toolhive/reference/api',
             },
+            {
+              label: 'ToolHive Operator CRD',
+              to: 'toolhive/reference/crd-spec',
+            },
             {
               label: 'ToolHive Registry schema',
               to: 'toolhive/reference/registry-schema',
             },
             {
-              label: 'ToolHive Operator CRD',
-              to: 'toolhive/reference/crd-spec',
+              label: 'ToolHive Registry API',
+              to: 'toolhive/reference/registry-api',
             },
           ],
         },

sidebars.ts

@@ -198,6 +198,7 @@ const sidebars: SidebarsConfig = {
         'toolhive/guides-registry/authentication',
         'toolhive/guides-registry/database',
         'toolhive/guides-registry/deployment',
+        'toolhive/reference/registry-api',
       ],
     },