a5bb182c67
Explicitly mention that directio of pagination is specified by the token
9 years ago
a66a744c45
Fix typo. Change responses in both places
9 years ago
06649b652d
Mark booleans as required. Remove mention that things may be null
9 years ago
e8b21f357f
Explicitlty mention total_room_count_estimate
9 years ago
e854757c98
Mark required fields as required
9 years ago
0dc94d5c14
Expand on description of pagination tokens
9 years ago
c05ee18f58
Add title and update description
9 years ago
130ea85576
Spec POST /publicRooms
9 years ago
877a6cfeb4
Spec new query params for /publicRooms
9 years ago
d81d0dbd1d
Spec canonical alias key
9 years ago
cade909e25
Fix inconsistencies regarding redacted_because
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
9 years ago
7478e7f3cf
Add top-level account_data to /sync response
9 years ago
77b668a5dc
Fix some obsolete uses of user_id key in events
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
9 years ago
978d9ea6dd
fix the descriptions of the /room/.../state APIs to not be the wrong way round
9 years ago
c51c4acf7f
Clarifications to authentication mechanisms
...
* Make the purpose of the `auth` key in /register requests explicit, and say
that it should be empty at first.
* Restructure the UA-auth section a bit.
* In the UA-auth section, say that clients should submit no `auth` to start
with, and add 'Stage 0' representing this to the example.
* s/{stage,login} type/authentication type/ in the UA-auth section. Seems
clearer to me.
* Try to distinguish the example responses from the example requests by giving
an HTTP header.
9 years ago
4b0e546eeb
PR feedback
...
Fix some typos, and clarify several aspects of server behaviour.
9 years ago
41368dc5a7
document CAS login
...
Following the spirit of "document how it is, not how we wish it was", document
the CAS login bits.
9 years ago
d2fe2f1ff6
Fix jenkins
9 years ago
618f94699b
Document the optional parameter for specifying a filename to download an attachment as
9 years ago
8328e485ea
Clean up the pushrules API doc
...
* make it clearer which fields go in which parts of the rule
* the example given appeared to be for a content rule, so use a content rule
consistently through the examples.
10 years ago
7ac2f51e4a
/upload: fix example for filename
...
The example shouldn't be encoded, else it will be double-encoded by swagger.
10 years ago
3e2dea4c52
Document filename query parameter for uploads
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
10 years ago
ec20f15407
/tokenrefresh should expire the access token
...
It's possible for clients to call /tokenrefresh before the access_token has
expired, potentially leading to a proliferation of valid access_tokens.
10 years ago
2370a4c970
Spell out the state algorithm for createRoom
...
Fixes https://matrix.org/jira/browse/SPEC-429 .
Synapse currently follows the specified ordering, but does *not* give the
specified error when the state is invalid (instead it creates the room anyway
but gives a 403 M_FORBIDDEN). Still, I don't think that should be a real
problem for any real clients, and nothing would break if we changed this in
synapse, so it might as well go in the spec anyway.
10 years ago
a48437ced8
Spec /account/deactivate API
10 years ago
a9d3cfd13c
Merge branch 'master' into rav/link_undeprecated_endpoints
10 years ago
d92515bce3
Merge pull request #354 from matrix-org/rav/reorder_deprecated_initialsync
...
Move /room/x/initialSync to after the undeprecated APIs
10 years ago
7080fd0618
Merge pull request #348 from Ralith/room-messages
...
Add missing "to" parameter to /messages
10 years ago
dc7fc0309e
Add missing "to" parameter to /messages
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
10 years ago
49cd65dd58
Add a license to the spec
...
We're licensing hte spec under ASLv2. Add the LICENSE file, and add the
short-form to as much of the source as is practical right now (adding it to
json source is a massive pita).
10 years ago
6bcb1798f5
Mark deprecated endpoints with their replacements
...
Fixes https://matrix.org/jira/browse/SPEC-415
10 years ago
9d267795e0
Move /room/x/initialSync to after the undeprecated APIs
...
It's a bit incongruous to have to read through the deprecated /initialSync to
get to the good stuff. Separate out intialSync so that we can move it later in
the spec.
10 years ago
e91214e78e
More links
...
Also remove now redundant anchor
10 years ago
cf13c8997c
Merge branch 'dbkr/dont_line_wrap_rst' into dbkr/more_requesttokens
10 years ago
7c8651480a
Some PR feedback corrections
...
Including adding a hyperlink, although this requires a separate fix that I'll do on a different branch
10 years ago
19a59bc210
Merge pull request #345 from Ralith/require-prev_batch
...
Supply prev_batch unconditionally in timelines
10 years ago
c109da5b78
Attempt to make things clearer
10 years ago
86db820bb1
Expand on summaries for requestToken endpoints
10 years ago
191cb08a3a
Add response section otherwise the checker fails
10 years ago
d74a320edd
Stray tab
10 years ago
ead5648b8c
Add requestToken endpoints
...
For password reset and 3pid adding
10 years ago
ee5054fb42
Supply prev_batch unconditionally in timelines
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
10 years ago
14ff3862e3
More PR feedback
10 years ago
e4db7be8e2
Better structure for error response
...
& add server not trusted error
10 years ago
3dddc0dcdf
Explain why not erroring on dup 3pid is desireable
10 years ago
a600386c05
Consistent working for error response
...
Also format json example better
10 years ago
60293af83a
PR feedback
10 years ago
6a0c9edb49
Add the id_server param
10 years ago
b0194a3016
Spec for endpoint-specific 3pid verification token
...
As per proposal https://docs.google.com/document/d/13mapDbaOnbob9ZYRDiGm1YbeZhFOBj_R1OvgBA9pA5s/edit?pref=2&pli=1#
10 years ago
4f37e4ece0
Merge pull request #342 from matrix-org/erikj/presence
...
Fix and correctly document presence's currently_active
10 years ago
Erik Johnston