Merge pull request #1109 from t3chguy/t3chguy/search_defaults

Document the defaults for the /search API
pull/1120/head
Richard van der Hoff 7 years ago committed by GitHub
commit 96fa29ad03
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -99,7 +99,9 @@ paths:
title: "Ordering" title: "Ordering"
type: string type: string
enum: ["recent", "rank"] enum: ["recent", "rank"]
description: "The order in which to search for results." description: |-
The order in which to search for results.
By default, this is ``"rank"``.
event_context: event_context:
title: "Event Context" title: "Event Context"
type: object type: object
@ -112,13 +114,13 @@ paths:
title: "Before limit" title: "Before limit"
description: |- description: |-
How many events before the result are How many events before the result are
returned. returned. By default, this is ``5``.
after_limit: after_limit:
type: integer type: integer
title: "After limit" title: "After limit"
description: |- description: |-
How many events after the result are How many events after the result are
returned. returned. By default, this is ``5``.
include_profile: include_profile:
type: boolean type: boolean
title: "Return profile information" title: "Return profile information"
@ -126,6 +128,7 @@ paths:
Requests that the server returns the Requests that the server returns the
historic profile information for the users historic profile information for the users
that sent the events that were returned. that sent the events that were returned.
By default, this is ``false``.
include_state: include_state:
type: boolean type: boolean
title: Include current state title: Include current state

@ -14,7 +14,9 @@ Unreleased changes
endpoints as deprecated endpoints as deprecated
(`#1097 <https://github.com/matrix-org/matrix-doc/pull/1097>`_). (`#1097 <https://github.com/matrix-org/matrix-doc/pull/1097>`_).
- Fix response format of ``/keys/changes`` endpoint - Fix response format of ``/keys/changes`` endpoint
(`#1106 <https://github.com/matrix-org/matrix-doc/pull/1106>`_) (`#1106 <https://github.com/matrix-org/matrix-doc/pull/1106>`_).
- Clarify default values for some fields on the /search API
(`#1109 <https://github.com/matrix-org/matrix-doc/pull/1109>`_).
- Changes to the API which will be backwards-compatible for clients: - Changes to the API which will be backwards-compatible for clients:

Loading…
Cancel
Save