diff --git a/frontend/src/metabase/lib/entities.js b/frontend/src/metabase/lib/entities.js
index 3396c10994023de72fbe3eaf8461069392b0ee31..d35b59d32df591530b0f8d4fe850797faaa5044d 100644
--- a/frontend/src/metabase/lib/entities.js
+++ b/frontend/src/metabase/lib/entities.js
@@ -1,6 +1,12 @@
 /*
  * # Entities abstract the interface between the back-end and the front-end.
  *
+ * ## Endpoint requirements for entities:
+ *
+ * When fetching a list, each item of the list must include an `id` key/value pair.
+ *
+ * JSON must wrap response inside a `{ "data" : { …your data } }` structure.
+ *
  * ## Required Properties:
  *
  * name: