feat: add apollo studio docs (#375)

Before Submitting This PR, Please Ensure You Have Completed The
Following:

1. [ ] Are internal links to wiki documents using [relative file
links](https://docusaurus.io/docs/markdown-features/links)?
2. [ ] Are all new documentation files lowercase, with dash separated
names (ex. unraid-os.mdx)?
3. [ ] Are all assets (images, etc), located in an assets/ subfolder
next to the .md/mdx files?
4. [ ] Have you checked to ensure there aren't other open [Pull
Requests](../../../pulls) for the same update/change?
5. [ ] Is the build succeeding?

Author: elibosley

docs/API/how-to-use-the-api.mdx

@@ -19,6 +19,16 @@ The Unraid API provides a %%GraphQL|graphql%% interface that allows you to inter
 
 ### WebGUI method (recommended)
 
+:::tip[📖 Live Documentation]
+
+**View the complete API schema and documentation:**
+
+**[View Live Documentation in Apollo GraphQL Studio →](https://studio.apollographql.com/graph/Unraid-API/variant/current/home)**
+
+The Apollo GraphQL Studio provides a comprehensive view of all available queries, mutations, types, and fields with full documentation. Use it to explore the schema structure and understand available operations.
+
+:::
+
 Using the %%WebGUI|web-gui%% is the easiest way to enable the %%GraphQL|graphql%% sandbox:
 
 1. Navigate to ***Settings → Management Access → Developer Options***
@@ -146,10 +156,26 @@ query {
 
 The API includes several core types. Base types include `Node` (interface for objects with unique IDs; see [Object Identification](https://graphql.org/learn/global-object-identification/)), `JSON` (for complex JSON data), `DateTime` (for timestamp values), and `Long` (for 64-bit integers). Resource types include `Array` (%%array|array%% and disk management), `Docker` (container and network management), `Info` (system information), `Config` (server configuration), and `Connect` (remote access settings). Available roles are `admin` (full access), `connect` (remote access features), and `guest` (limited read access).
 
-Use the Apollo Sandbox to explore the schema and test queries. Start with small queries and gradually add fields as needed. Monitor your query complexity to maintain performance, use appropriate roles and permissions for your API keys, and keep your API keys secure by rotating them periodically.
+## Best practices
+
+:::tip[Pro Tips]
+
+1. Use [Apollo GraphQL Studio](https://studio.apollographql.com/graph/Unraid-API/variant/current/home) to view and explore the complete API schema and documentation
+2. Start with small queries and gradually add fields as needed
+3. Monitor your query complexity to maintain performance
+4. Use appropriate roles and permissions for your API keys
+5. Keep your API keys secure and rotate them periodically
+
+:::
 
 ## Error handling and rate limiting
 
+:::caution[Rate Limits]
+
+The API implements rate limiting to prevent abuse. Ensure your applications handle rate limit responses appropriately.
+
+:::
+
 The API returns standard %%GraphQL|graphql%% errors in the following format:
 
 ```json
@@ -164,6 +190,18 @@ The API returns standard %%GraphQL|graphql%% errors in the following format:
 }
 ```
 
-The API implements rate limiting to prevent abuse. Ensure your applications handle rate limit responses appropriately. Use the Apollo Sandbox's schema explorer to browse all available types and fields, and check the documentation tab for detailed field descriptions. Monitor the API's health using `unraid-api status` and generate reports using `unraid-api report` for troubleshooting. For more information about specific commands and configuration options, refer to the [CLI documentation](cli.mdx) or run `unraid-api --help`. If you encounter issues, visit the [Unraid forums](https://forums.unraid.net/) for community support.
+## Additional resources
+
+:::info[Learn More]
+
+- View the complete API schema and documentation using [Apollo GraphQL Studio](https://studio.apollographql.com/graph/Unraid-API/variant/current/home)
+- Use the Apollo Sandbox's schema explorer to browse all available types and fields
+- Check the documentation tab in Apollo Sandbox for detailed field descriptions
+- Monitor the API's health using `unraid-api status`
+- Generate reports using `unraid-api report` for troubleshooting
+
+For more information about specific commands and configuration options, refer to the [CLI documentation](cli.mdx) or run `unraid-api --help`. If you encounter issues, visit the [Unraid forums](https://forums.unraid.net/) for community support.
+
+:::
 
 <!-- markdownlint-enable MD025 MD033 -->