de961fb7d6
Improve wording on push gateways
6 years ago
fcca80dad8
various minor fixes
...
- formatting fixes
- add examples to homeserver/identity server discovery schema
- replace DNS name with hostname
6 years ago
6a3cf10be9
Merge remote-tracking branch 'origin/master' into well-known
6 years ago
6ad71f785e
Improve documentation for pushers and push gateways
...
This fixes a number of formatting issues alongside a few documentation problems:
* The push gateway can actually expect less parameters than previously advertised. This is for user privacy.
* Introduction of the `m.email` pusher for email-capable homeservers.
* Fields not being flagged as required on some endpoints.
* Document the `event_id_only` format
Note: this does not attempt to document push rules, just pushers.
Fixes https://github.com/matrix-org/matrix-doc/issues/1374
Fixes https://github.com/matrix-org/matrix-doc/issues/1087
6 years ago
292d334509
document new login identifier object ( #1390 )
6 years ago
8ffac01efe
Document OpenID in the client-server API
...
Part of https://github.com/matrix-org/matrix-doc/issues/857
Reference: d69decd5c7/synapse/rest/client/v2_alpha/openid.py (L31-L58)
6 years ago
2ac80d38d7
Document the /publicRooms endpoint for federation
...
This intentionally doesn't document the third party network aspect of the endpoint. This is scheduled for a later area for dealing with third party network/IDs and is reported as https://github.com/matrix-org/matrix-doc/issues/1476
The client-server response has been broken out to a shared file: both the client-server and server-server /publicRoom endpoints return the same thing, with slightly different inputs.
The inputs (and behaviour) are based upon the docstring here: 43ecfe0b10/synapse/federation/transport/server.py (L583-L612)
6 years ago
54a88eebf0
Merge pull request #1414 from matrix-org/anoa/third_party_cleanup
...
Clarification on third party fields
6 years ago
5f8967c074
Move TODO. field1, field2... -> fields...
6 years ago
a2e2ced03b
Add reverse-lookup examples.
6 years ago
d785ac78a3
Remove explode and replace with TODO, require auth on CS
6 years ago
53137a3c53
c/p bug, fix operationIds, move rst docs to md
6 years ago
273acb277c
Change fields to use new extended query array syntax
6 years ago
5ddf5374db
Missing comma
6 years ago
e4fd088fcc
Fix room tags spec
6 years ago
05fb94e195
Merge remote-tracking branch 'matrix-org/master' into travis/better-errors
6 years ago
d2b0b1bbda
Merge pull request #1379 from turt2live/travis/preset-guests
...
Document guest_access in /createRoom presets; Make presets a table
6 years ago
1829589d23
Convert 3pn errors to new definition
6 years ago
197c36c520
Merge remote-tracking branch 'matrix-org/master' into travis/better-errors
6 years ago
91c59e7384
Merge pull request #1353 from matrix-org/anoa/as_thirdparty_lookup
...
Thirdparty Entity Lookup API
6 years ago
291a4dfc76
Third party lookup module. Fix wording
6 years ago
6e3993effe
Merge remote-tracking branch 'matrix-org/master' into travis/preset-guests
6 years ago
84e07a0c10
Convert errors in presence.yaml
6 years ago
16125f16f5
Spec retry_after_ms on ratelimit errors
6 years ago
8b513b9f8e
Merge remote-tracking branch 'matrix-org/master' into travis/better-errors
6 years ago
8999887245
Path -> query params
6 years ago
9bde78ac28
$ref needs to be under a schema:
6 years ago
114bcf1a2e
Use $ref, clean up, fix errors, AS is now a C-S module.
6 years ago
fbee83d5cf
Clarify some of the properties on the search result
...
Fixes https://github.com/matrix-org/matrix-doc/issues/773
6 years ago
d7a979da63
Merge remote-tracking branch 'matrix-org/master' into travis/all-the-auth
6 years ago
516000bdc3
Fix error reference in media repo
6 years ago
ab75fc4b20
Merge remote-tracking branch 'matrix-org/master' into travis/better-errors
6 years ago
e7a6ff1064
Merge branch 'master' into travis/spec-reason
6 years ago
1722734a51
Merge pull request #1364 from turt2live/travis/server-name-join
...
Document the server_name query parameter on /join/{roomIdOrAlias}
6 years ago
ff3c379339
Merge pull request #1189 from Half-Shot/hs/upload-limits
...
GET media/config 🎉
6 years ago
77f4ac54aa
Wordy intro sentence for description
6 years ago
2e6cc8045c
Better indent of description
6 years ago
d5ce87e956
Split summary up into description and summary
6 years ago
bbf63d116c
Fix reference to error.yaml in forget room API
6 years ago
55c27d6212
Merge branch 'master' into travis/better-errors
6 years ago
4485b2f025
Merge branch 'master' into travis/server-name-join
6 years ago
c1c1f28c79
Merge branch 'master' into travis/dont-forget-to-leave
6 years ago
3935861445
Merge pull request #1380 from turt2live/travis/define-roomevent
...
Define RoomEvent on /rooms/{roomId}/messages
6 years ago
16860ddd22
De-quote
6 years ago
4c38012122
I can spell
6 years ago
e6218b56ab
Switch properties to schema
6 years ago
a6dad76c01
Fix indentation
6 years ago
cc3724b54a
fix indentation, error messages. add rest of PR
6 years ago
dfdc5f9bef
search.yaml: Rename some titles to avoid confusion between request and response schemas
...
Signed-off-by: Alexey Rusakov <Alexey.Rusakov@pm.me>
6 years ago
436b410698
Document the error code when someone tries to forget a room they are in
6 years ago
9b1f3a1f47
Document guest_access in /createRoom presets; Make presets a table
...
Previously the presets ended up being rendered as one long string (the indentation was not respected). This was hard to read and wasn't very clear.
Now that there's a larger amount of information, it makes some sense to put it into a table. Tables don't work nicely when nested in another table, so the preset definitions have been moved into the general route description.
This commit also updates the documentation to reference `preset`, not `presets` given the param is singular.
Fixes https://github.com/matrix-org/matrix-doc/issues/881
6 years ago
ce1e2c0904
incorporate feedback from reviewers
6 years ago
9e796192e4
Document that clients must leave before forgetting rooms
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1011
6 years ago
5bc29eb11c
remove accidentally-committed backup file
6 years ago
05c85fd840
Spec the 403 on GET /presence/{userId}/status
6 years ago
981d1004bc
Add a missing $ref
6 years ago
442ad99727
Merge pull request #1273 from QMatrixClient/content-repo-use-default
...
Add 'default' to formally enforce the description
6 years ago
caa6d4d9ad
Give all errors a schema reference
...
This just helps keep an overall structure
6 years ago
7cd22f5690
Describe the rate limit error everywhere
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1153
6 years ago
1f12637d3f
Getting presence requires authentication
6 years ago
a6b0125da6
Our swagger doesn't support explode yet
6 years ago
d279fdafa6
Document the server_name query parameter on /join/{roomIdOrAlias}
...
Fixes https://github.com/matrix-org/matrix-doc/issues/904
6 years ago
7d94aaace8
Explicitly declare that the kick/ban reason will be on the membership event
...
Fixes https://github.com/matrix-org/matrix-doc/issues/798
6 years ago
2409c84968
Document the GET version of /login
...
Fixes https://github.com/matrix-org/matrix-doc/issues/677
6 years ago
0dd330962d
initial draft of .well-known discovery
6 years ago
a1309d636c
Remove "Clients should handle gracefully" sentence
6 years ago
41c18bed0f
+repository
6 years ago
21e957edfb
Better note for /config
6 years ago
1820df02d9
media => content repository
6 years ago
091b2a6771
Hard limit on requiring accessToken. Rephrased some sections
6 years ago
eeaf4385d7
Speling is my weakniss
6 years ago
80935eadcf
Update content-repo.yaml
6 years ago
ddc152347b
Extending words and rate limiting
6 years ago
f032d6d1c3
Update keys.yaml
...
Fixed an end to end document bug , a format misleading in an claim response
6 years ago
1140c0c05b
Document StateEvent for /createRoom ( #1329 )
6 years ago
6d0a56d190
Suggestions by Travis tend to be sensible ones
6 years ago
6b9640bcb4
upload_size => m.upload.size
6 years ago
077cd04a6d
/limits => /config
6 years ago
df5455de1f
re-arrange fields in example /search request to make them a valid request.
6 years ago
64f97c5b78
add example of highlights field in /search response
6 years ago
4ff5887c91
spec the highlights field in /search response
6 years ago
42fba1a87e
Add 'default' to formally enforce the description
...
A quick follow up on #1265 .
Signed-off-by: Alexey Rusakov <Alexey.Rusakov@pm.me>
6 years ago
3dc54b20c6
Merge branch 'master' into travis/clarify-routing-loops
6 years ago
8610effad7
Merge branch 'master' into travis/reporting
6 years ago
7cc15f3315
Document the allow_remote query param on the media repo
...
Fixes https://github.com/matrix-org/matrix-doc/issues/837
Signed-off-by: Travis Ralston <travpc@gmail.com>
6 years ago
9037f506ac
Document how to report content
...
Fixes: https://github.com/matrix-org/matrix-doc/issues/739
Signed-off-by: Travis Ralston <travpc@gmail.com>
6 years ago
4278cd56a4
Document /logout/all
...
Fixes https://github.com/matrix-org/matrix-doc/issues/700
Signed-off-by: Travis Ralston <travpc@gmail.com>
6 years ago
cc54a4f8cb
/rooms/{roomId}/members: specify access_token requirement
...
as the behaviour of which members the users see is user-specific
and therefore requires authentication.
Signed-off-by: Florian Jacob <projects+git AT florianjacob )DOT( de>
6 years ago
bb39bea44d
Merge pull request #1169 from mujx/event-id-format
...
Use the correct event_id format on examples
6 years ago
55b512c968
add delete_devices endpoint
...
fix #1041
6 years ago
34140a785d
fix typo in delete device
6 years ago
ffc8ee298a
a upload > an upload
6 years ago
de6fe1b76e
Add note about auth
6 years ago
c9abf36097
size > upload_size
6 years ago
2783820f98
Initial draft of GET media/limits
6 years ago
048de9803e
Fix typo.
6 years ago
7448ef0db0
Use the correct event_id format on examples
...
Signed-off-by: Konstantinos Sideris <sideris.konstantin@gmail.com>
6 years ago
cd26c170de
Specify token used in /login is not an Access Token ( #1155 )
...
* Specify token used in /login is not an Access Token
While working through the implementation of /login in Dendrite, it was
confusing what the contents of the token attribute in the login request
body referred to. Initially, I thought it was an access token, which led
to further confusion. This commit explicitly states that the token is a
login token, which is separate from an access token, hopefully reducing
confusion for future readers.
Signed-off-by: Andrew Morgan (https://amorgan.xyz ) <andrew@amorgan.xyz>
6 years ago
2644e5657d
Merge pull request #1152 from turt2live/travis/clarify-whoami
...
Improve documentation around /account/whoami
6 years ago
159ab7313f
Fix typos in whoami.yaml
...
Signed-off-by: Travis Ralston <travpc@gmail.com>
6 years ago
Travis Ralston