docs: enhance API documentation with web GUI management options

- Added tips for managing developer options and API keys through the web interface.
- Updated the GraphQL sandbox enabling instructions to include a web GUI method.
- Clarified API key management and authentication methods, including SSO/OIDC.
- Revised the availability section to reflect native integration in Unraid v7.2 and provide guidance for earlier versions.

Author: elibosley

api/docs/public/cli.md

@@ -61,6 +61,10 @@ Switch between production and staging environments.
 
 ### Developer Mode
 
+:::tip Web GUI Management
+You can also manage developer options through the web interface at **Settings** → **Management Access** → **Developer Options**
+:::
+
 ```bash
 unraid-api developer                       # Interactive prompt for tools
 unraid-api developer --sandbox true        # Enable GraphQL sandbox
@@ -76,13 +80,17 @@ Configure developer features for the API:
 
 ## API Key Management
 
+:::tip Web GUI Management
+You can also manage API keys through the web interface at **Settings** → **Management Access** → **API Keys**
+:::
+
 ### API Key Commands
 
 ```bash
 unraid-api apikey [options]
 ```
 
-Create and manage API keys.
+Create and manage API keys via CLI.
 
 Options:
 
@@ -94,6 +102,10 @@ Options:
 
 ## SSO (Single Sign-On) Management
 
+:::info OIDC Configuration
+For OIDC/SSO provider configuration, see the web interface at **Settings** → **Management Access** → **API** → **OIDC** or refer to the [OIDC Provider Setup](./oidc-provider-setup.md) guide.
+:::
+
 ### SSO Base Command
 
 ```bash

api/docs/public/how-to-use-the-api.md

@@ -4,36 +4,52 @@ The Unraid API provides a GraphQL interface that allows you to interact with you
 
 ## Enabling the GraphQL Sandbox
 
-1. Enable developer mode using the CLI:
-
-    ```bash
-    unraid-api developer --sandbox true
-    ```
-    
-    Or use the interactive mode:
-    
-    ```bash
-    unraid-api developer
-    ```
-
-2. Once enabled, you can access the Apollo Sandbox interface
+### Web GUI Method (Recommended)
 
+1. Navigate to **Settings** → **Management Access** → **Developer Options**
+2. Enable the **GraphQL Sandbox** toggle
 3. Access the GraphQL playground by navigating to:
 
     ```txt
     http://YOUR_SERVER_IP/graphql
     ```
 
+### CLI Method
+
+Alternatively, you can enable developer mode using the CLI:
+
+```bash
+unraid-api developer --sandbox true
+```
+
+Or use the interactive mode:
+
+```bash
+unraid-api developer
+```
+
 ## Authentication
 
 Most queries and mutations require authentication. You can authenticate using either:
 
 1. API Keys
 2. Cookies (default method when signed into the WebGUI)
+3. SSO/OIDC (when configured)
+
+### Managing API Keys
 
-### Creating an API Key
+#### Web GUI Method (Recommended)
 
-Use the CLI to create an API key:
+Navigate to **Settings** → **Management Access** → **API Keys** in your Unraid web interface to:
+
+- View existing API keys
+- Create new API keys
+- Manage permissions and roles
+- Revoke or regenerate keys
+
+#### CLI Method
+
+You can also use the CLI to create an API key:
 
 ```bash
 unraid-api apikey --create
@@ -46,6 +62,8 @@ Follow the prompts to set:
 - Roles
 - Permissions
 
+### Using API Keys
+
 The generated API key should be included in your GraphQL requests as a header:
 
 ```json

api/docs/public/index.md

@@ -2,21 +2,28 @@
 
 The Unraid API provides a GraphQL interface for programmatic interaction with your Unraid server. It enables automation, monitoring, and integration capabilities.
 
-## Current Availability
+## Availability
 
-The API is available through the Unraid Connect Plugin:
+### Native Integration (Unraid v7.2-beta.1+)
 
-1. Install Unraid Connect Plugin from Apps
-2. [Configure the plugin](./how-to-use-the-api.md#enabling-the-graphql-sandbox)
-3. Access API functionality through the [GraphQL Sandbox](./how-to-use-the-api.md#accessing-the-graphql-sandbox)
+Starting with Unraid v7.2-beta.1, the API is integrated directly into the Unraid operating system:
+
+- No plugin installation required
+- Automatically available on system startup
+- Deep system integration
+- Access through **Settings** → **Management Access** → **API**
 
-## Future Availability
+### Plugin Installation (Earlier Versions)
 
-The API will be integrated directly into the Unraid operating system in an upcoming OS release. This integration will:
+For Unraid versions prior to v7.2:
+
+1. Install Unraid Connect Plugin from Apps
+2. [Configure the plugin](./how-to-use-the-api.md#enabling-the-graphql-sandbox)
+3. Access API functionality through the [GraphQL Sandbox](./how-to-use-the-api.md)
 
-- Make the API a core part of the Unraid system
-- Remove the need for separate plugin installation
-- Enable deeper system integration capabilities
+:::tip Pre-release Versions
+You can install the Unraid Connect plugin on any version to access pre-release versions of the API and get early access to new features before they're included in Unraid OS releases.
+:::
 
 ## Documentation Sections
 
@@ -29,10 +36,11 @@ The API will be integrated directly into the Unraid operating system in an upcom
 
 The API provides:
 
-- GraphQL Interface: Modern, flexible API with strong typing
-- Authentication: Secure access via API keys or session cookies
-- Comprehensive Coverage: Access to system information, array management, and Docker operations
-- Developer Tools: Built-in GraphQL sandbox for testing
-- Role-Based Access: Granular permission control
+- **GraphQL Interface**: Modern, flexible API with strong typing
+- **Authentication**: Multiple methods including API keys, session cookies, and SSO/OIDC
+- **Comprehensive Coverage**: Access to system information, array management, and Docker operations
+- **Developer Tools**: Built-in GraphQL sandbox configurable via web interface or CLI
+- **Role-Based Access**: Granular permission control
+- **Web Management**: Manage API keys and settings through the web interface
 
 For detailed usage instructions, see [CLI Commands](./cli.md).

api/docs/public/oidc-provider-setup.md

@@ -272,11 +272,10 @@ LOG_LEVEL=debug unraid-api start --debug
 
 ## Security Best Practices
 
-1. **Use HTTPS when possible** - Provides encrypted connections for authentication
-2. **Use Simple Mode for authorization** - Prevents overly accepting configurations and reduces misconfiguration risks
-3. **Be specific with authorization** - Don't use overly broad rules
-4. **Rotate secrets regularly** - Update client secrets periodically
-5. **Test thoroughly** - Verify only intended users can access
+1. **Use Simple Mode for authorization** - Prevents overly accepting configurations and reduces misconfiguration risks
+2. **Be specific with authorization** - Don't use overly broad rules
+3. **Rotate secrets regularly** - Update client secrets periodically
+4. **Test thoroughly** - Verify only intended users can access
 
 ## Need Help?
 
@@ -292,6 +291,7 @@ LOG_LEVEL=debug unraid-api start --debug
 The Unraid.net provider is built-in and pre-configured. You only need to configure authorization rules in the interface.
 
 **Configuration:**
+
 - **Issuer URL**: Pre-configured (built-in provider)
 - **Client ID/Secret**: Pre-configured (built-in provider)
 - **Redirect URI**: `http://YOUR_UNRAID_IP/graphql/api/auth/oidc/callback`

api/docs/public/upcoming-features.md

@@ -167,6 +167,6 @@ We value community input! Please submit feature requests and feedback through:
 Versions prior to Unraid 7.2 require the API to be installed through the Unraid Connect plugin. Some features may not be available on older versions.
 :::
 
-:::tip Development Builds
-You can always install the Unraid Connect plugin to track the latest released development changes and get early access to new API features before they're included in Unraid OS releases.
+:::tip Pre-release Versions
+You can always install the Unraid Connect plugin to access pre-release versions of the API and get early access to new features before they're included in Unraid OS releases.
 :::