diff --git a/modules/schema/src/main/resources/lucuma/odb/graphql/OdbSchema.graphql b/modules/schema/src/main/resources/lucuma/odb/graphql/OdbSchema.graphql
index 223de8d22..fdc658756 100644
--- a/modules/schema/src/main/resources/lucuma/odb/graphql/OdbSchema.graphql
+++ b/modules/schema/src/main/resources/lucuma/odb/graphql/OdbSchema.graphql
@@ -9594,6 +9594,11 @@ type Query {
   ): ObservationSelectResult!
 
 
+  """
+  Selects observations via a normal predicate *and* an additional filter for allowed
+  workflow states. This query is intended for operations and is available only for
+  service users.
+  """
   observationsByWorkflowState(
     WHERE: WhereObservation,
     states: [ObservationWorkflowState!]