add keyword search and tag filtering to list_questions()

Author: SeaBlooms

examples/08_questions_management.py

@@ -315,6 +315,40 @@ def list_questions_example(j1):
         if len(questions) > 5:
             print(f"\n... and {len(questions) - 5} more questions")
 
+        # Demonstrate filtering capabilities
+        print("\n=== Filtering Examples ===")
+        
+        # Search by content
+        print("\n1. Searching for security-related questions:")
+        security_questions = j1.list_questions(search_query="security")
+        print(f"  Found {len(security_questions)} questions with 'security' in title/description")
+        if security_questions:
+            print(f"  Example: {security_questions[0]['title']}")
+        
+        # Filter by tags
+        print("\n2. Filtering by compliance tags:")
+        compliance_questions = j1.list_questions(tags=["compliance"])
+        print(f"  Found {len(compliance_questions)} questions tagged with 'compliance'")
+        if compliance_questions:
+            print(f"  Example: {compliance_questions[0]['title']}")
+        
+        # Combine search and tags
+        print("\n3. Combining search and tags:")
+        security_compliance = j1.list_questions(
+            search_query="encryption", 
+            tags=["security", "compliance"]
+        )
+        print(f"  Found {len(security_compliance)} questions matching both criteria")
+        if security_compliance:
+            print(f"  Example: {security_compliance[0]['title']}")
+        
+        # Search for specific compliance standards
+        print("\n4. Searching for CIS compliance questions:")
+        cis_questions = j1.list_questions(search_query="CIS")
+        print(f"  Found {len(cis_questions)} questions related to CIS")
+        if cis_questions:
+            print(f"  Example: {cis_questions[0]['title']}")
+            
     except Exception as e:
         print(f"Error listing questions: {e}")
 

examples/README.md

@@ -204,7 +204,9 @@ python 08_questions_management.py
 
 ### 📊 Questions Management
 - Question creation with J1QL queries
-- Question listing and analysis
+- Question listing and analysis with filtering options
+- Search questions by title/description using `search_query` parameter
+- Filter questions by tags using `tags` parameter
 - Compliance metadata management
 - Question categorization and filtering
 - Question lifecycle management
@@ -280,11 +282,25 @@ j1 = JupiterOneClient(
 ```
 
 ### Questions Analysis
-Examples show how to analyze questions data:
+Examples show how to analyze questions data with filtering:
 ```python
 # List all questions
 questions = j1.list_questions()
 
+# Search questions by content
+security_questions = j1.list_questions(search_query="security")
+encryption_questions = j1.list_questions(search_query="encryption")
+
+# Filter questions by tags
+compliance_questions = j1.list_questions(tags=["compliance"])
+cis_questions = j1.list_questions(tags=["cis", "aws"])
+
+# Combine search and tags
+security_compliance = j1.list_questions(
+    search_query="encryption", 
+    tags=["security", "compliance"]
+)
+
 # Analyze by compliance standards
 compliance_standards = {}
 for question in questions:

examples/examples.py

@@ -575,22 +575,26 @@
 print(f"Total questions found: {len(list_questions_r)}")
 print(json.dumps(list_questions_r[:2], indent=1))  # Show first 2 questions
 
-# list_questions with filtering (if supported)
-# Note: The current implementation doesn't support filtering parameters,
-# but the GraphQL schema shows support for searchQuery, tags, etc.
-print("\nlist_questions() - Sample question details:")
-if list_questions_r:
-    sample_question = list_questions_r[0]
-    print(f"  Title: {sample_question.get('title', 'No title')}")
-    print(f"  ID: {sample_question.get('id', 'No ID')}")
-    print(f"  Description: {sample_question.get('description', 'No description')}")
-    print(f"  Tags: {sample_question.get('tags', [])}")
-    print(f"  Number of queries: {len(sample_question.get('queries', []))}")
-    if sample_question.get('queries'):
-        for i, query in enumerate(sample_question['queries']):
-            print(f"    Query {i+1}: {query.get('name', 'Unnamed')} - {query.get('query', 'No query')[:50]}...")
-else:
-    print("  No questions found in the account")
+# list_questions with search query
+print("\nlist_questions() - With search query:")
+security_questions = j1.list_questions(search_query="security")
+print(f"Security-related questions found: {len(security_questions)}")
+if security_questions:
+    print(f"  First security question: {security_questions[0].get('title', 'No title')}")
+
+# list_questions with tags filter
+print("\nlist_questions() - With tags filter:")
+compliance_questions = j1.list_questions(tags=["compliance"])
+print(f"Compliance-tagged questions found: {len(compliance_questions)}")
+if compliance_questions:
+    print(f"  First compliance question: {compliance_questions[0].get('title', 'No title')}")
+
+# list_questions with combined search and tags
+print("\nlist_questions() - With search and tags:")
+security_compliance = j1.list_questions(search_query="encryption", tags=["security", "compliance"])
+print(f"Security/compliance encryption questions found: {len(security_compliance)}")
+if security_compliance:
+    print(f"  First matching question: {security_compliance[0].get('title', 'No title')}")
 
 # list_questions - analyze question types and compliance
 print("\nlist_questions() - Analysis:")

jupiterone/client.py

@@ -1246,12 +1246,44 @@ def fetch_downloaded_evaluation_results(self, download_url: str = None):
 
             return e
 
-    def list_questions(self):
-        """List all defined Questions configured in J1 Account Questions Library"""
+    def list_questions(self, search_query: str = None, tags: List[str] = None):
+        """List all defined Questions configured in J1 Account Questions Library
+        
+        Args:
+            search_query (str, optional): Search query to filter questions by title or description
+            tags (List[str], optional): List of tags to filter questions by
+            
+        Returns:
+            List[Dict]: List of question objects
+            
+        Example:
+            # List all questions
+            all_questions = j1_client.list_questions()
+            
+            # Search for security-related questions
+            security_questions = j1_client.list_questions(search_query="security")
+            
+            # Filter by specific tags
+            compliance_questions = j1_client.list_questions(tags=["compliance", "cis"])
+            
+            # Combine search and tags
+            security_compliance = j1_client.list_questions(
+                search_query="encryption", 
+                tags=["security", "compliance"]
+            )
+        """
         results = []
 
+        # Build variables for the GraphQL query
+        variables = {}
+        if search_query:
+            variables["searchQuery"] = search_query
+        if tags:
+            variables["tags"] = tags
+
         data = {
             "query": QUESTIONS,
+            "variables": variables,
             "flags": {
                 "variableResultSize": True
             }
@@ -1267,10 +1299,16 @@ def list_questions(self):
             cursor = r["data"]["questions"]["pageInfo"]["endCursor"]
 
             # cursor query until last page fetched
+            # Preserve existing variables and add cursor
+            cursor_variables = variables.copy()
+            cursor_variables["cursor"] = cursor
+            
             data = {
                 "query": QUESTIONS,
-                "variables": {"cursor": cursor},
-                "flags": {"variableResultSize": True},
+                "variables": cursor_variables,
+                "flags": {
+                    "variableResultSize": True
+                },
             }
 
             r = requests.post(