Improve API documentation with additional details

- Fix ask parameter to be mandatory in Holmes Chat API
- Add API key generation instructions to Prometheus Query API
- Add Holmes Chat API reference to Robusta Pro Features
- Add markdown response handling examples for Holmes Chat API

https://claude.ai/code/session_01MLXAVw9RVcPfGyUhy1XeDQ

Author: claude

docs/configuration/exporting/prometheus-query-api.rst

@@ -79,7 +79,7 @@ Include an API key in the Authorization header:
 
     Authorization: Bearer <API_KEY>
 
-The API key must have **Read Metrics** permission.
+The API key must have **Read Metrics** permission. You can generate this token in the platform by navigating to **Settings** -> **API Keys** -> **New API Key**, and creating a key with the "Read Metrics" permission.
 
 Example Request
 ---------------

docs/configuration/exporting/robusta-pro-features.rst

@@ -14,6 +14,9 @@ Automatically investigate and resolve issues with AI-powered analysis.
 :doc:`AI Analysis (HolmesGPT) <../holmesgpt/main-features>`
     Automatically analyze Kubernetes alerts, logs, and metrics. Get potential root causes and remediation suggestions.
 
+:doc:`Holmes Chat API <../holmesgpt/holmes-chat-api>`
+    Programmatically send questions to Holmes AI for root cause analysis via REST API.
+
 Custom Alert Ingestion
 -----------------------
 

docs/configuration/holmesgpt/holmes-chat-api.rst

@@ -44,8 +44,8 @@ Request Body
      - No
    * - ``ask``
      - string
-     - The question to ask Holmes. Default: ``"Why is this alert firing?"``
-     - No
+     - The question to ask Holmes.
+     - Yes
    * - ``payload``
      - object
      - Alert payload or context data for Holmes to analyze (e.g., Prometheus alert labels).
@@ -133,6 +133,35 @@ Response Fields
      - string
      - Holmes AI analysis in markdown format. Contains investigation findings, root cause analysis, and remediation steps.
 
+Handling the Markdown Response
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The ``analysis`` field contains markdown text with escaped newlines (``\n``). To render it properly:
+
+**Python:**
+
+.. code-block:: python
+
+    import json
+
+    response_data = json.loads(response.text)
+    markdown_text = response_data["analysis"]  # Already unescaped by json.loads
+    print(markdown_text)  # Renders with proper line breaks
+
+**JavaScript:**
+
+.. code-block:: javascript
+
+    const data = JSON.parse(responseText);
+    const markdownText = data.analysis;  // Already unescaped by JSON.parse
+    // Use a markdown renderer like marked.js or react-markdown
+
+**Bash (using jq):**
+
+.. code-block:: bash
+
+    curl ... | jq -r '.analysis'  # -r outputs raw string with actual newlines
+
 Error Responses
 ^^^^^^^^^^^^^^^