You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec-proposals/api
Travis Ralston 45c68e323a Add general clarity to the /createRoom endpoint
This commit does a number of things:
* Minor formatting/alignment changes
* Document the room_alias response key. This could be deprecated now, or forfeited, if needed.
* Remove the guest_can_join parameter - it is not actually supported
* Document the previously undocumented power_level_content_override parameter
* Clarify that the room_id is required on the response
* More clearly spell out which events are created as part of the request
* Clarify how the room alias becomes the canonical alias
* Clarify how the `visibility` may be used to determine a default preset to apply
* Document the `m.federate` creation content parameter, adding an option for the homeserver to define a default value

References:
* Preset being inferred by the visibility: cd32c19a60/synapse/handlers/room.py (L172-L177)
* Power level content overrides:
  * https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L198
  * https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L335-L359
* Aliases becoming canonical: https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L366-L370
* `m.federate` landing in the create event: https://github.com/matrix-org/synapse/blob/master/synapse/handlers/room.py#L311-L315

Fixes https://github.com/matrix-org/matrix-doc/issues/1243
Fixes https://github.com/matrix-org/matrix-doc/issues/1471
Inspired by https://github.com/matrix-org/matrix-doc/issues/1213
6 years ago
..
application-service Move TODO. field1, field2... -> fields... 6 years ago
client-server Add general clarity to the /createRoom endpoint 6 years ago
files fix for https://github.com/matrix-org/matrix-doc/issues/270 9 years ago
identity convert IS endpoints to Swagger (#1427) 6 years ago
push-gateway Add operationId to all endpoints of all APIs 7 years ago
server-server Merge pull request #1469 from turt2live/travis/s2s/backfill 6 years ago
README README.rst: Add notes on how to build the spec 7 years ago
check_examples.py Revert giving get() a default 6 years ago
openapi_extensions.md Document OpenAPI extension 6 years ago
package.json Reinstate validator.js 8 years ago
validator.js Provide doc-comments with makeHandler(); cleanup 7 years ago

README

This directory contains swagger-compatible representations of our APIs. See
the main README.rst for details on how to make use of them.