diff --git a/changelogs/client_server/newsfragments/1239.clarification b/changelogs/client_server/newsfragments/1239.clarification new file mode 100644 index 000000000..f2c403d1a --- /dev/null +++ b/changelogs/client_server/newsfragments/1239.clarification @@ -0,0 +1 @@ +Clarify that `/context` always returns `event` even if `limit` is zero. Contributed by @sumnerevans at @beeper. diff --git a/data/api/client-server/event_context.yaml b/data/api/client-server/event_context.yaml index cf3476b09..4a2541a6d 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. Defaults to 10. x-example: 3 - in: query name: filter