diff --git a/docs/dev/api/insights.md b/docs/dev/api/insights.md
index 67d624d925..0062f1c456 100644
--- a/docs/dev/api/insights.md
+++ b/docs/dev/api/insights.md
@@ -24,6 +24,10 @@ Return run data for all tests that match the request criteria.
 
 #### Parameters
 
+:::note
+This call requires <code>start</code> and <code>end</code> parameters OR the <code>time_range</code> parameter.
+:::
+
 <table id="table-api">
   <tbody>
     <tr>
@@ -412,6 +416,10 @@ Return a set of data "buckets" representing tests that were run in each time int
 
 #### Parameters
 
+:::note
+This call requires <code>start</code> and <code>end</code> parameters OR the <code>time_range</code> parameter.
+:::
+
 <table id="table-api">
   <tbody>
     <tr>