query Parameters
There is also an undocumented parameter, _separate_replies
. When the value is "true"
the response object has, instead of a rows
key, a pair of keys: rows
and replies
.
When the /api/search
endpoint is invoked this way, the Hypothesis server ensures that all replies for each found annotation are included in the response. This enables the Hypothesis client to render complete threads for each API gulp of 200.
As suggested by the underscore prefix, the _separate_replies
was not intended to be a formal part of the API, and is expected to be made obsolete by a rethink of how the API deals with threaded conversations.