diff --git a/data/api/client-server/event_context.yaml b/data/api/client-server/event_context.yaml
index cf3476b0..659aea41 100644
--- a/data/api/client-server/event_context.yaml
+++ b/data/api/client-server/event_context.yaml
@@ -57,7 +57,10 @@ paths:
           type: integer
           name: limit
           description: |-
-            The maximum number of events to return. Default: 10.
+            The maximum number of context events to return. The limit applies
+            to the sum of the `events_before` and `events_after` arrays. The
+            requested event ID is always returned in `event` even if `limit` is
+            0. Default: 10.
           x-example: 3
         - in: query
           name: filter