diff --git a/proposals/2403-knock.md b/proposals/2403-knock.md index 5f99c93a..e601b7a2 100644 --- a/proposals/2403-knock.md +++ b/proposals/2403-knock.md @@ -191,16 +191,13 @@ Additionally, extensions to the `GET /_matrix/client/r0/sync` endpoint are introduced. These allow a client to receive information about the status of their knock attempt. -The newly proposed endpoint requires authentication and can be rate limited. - - ### `POST /_matrix/client/r0/knock/{roomIdOrAlias}` Or the knocking equivalent of [`POST /_matrix/client/r0/join/{roomIdOrAlias}`](https://matrix.org/docs/spec/client_server/r0.6.1#post-matrix-client-r0-join-roomidoralias). The path parameter (`roomIdOrAlias`) is either the room ID or the alias of -the room you want to knock on. Additionally several `server_name` parameters +the room you want to knock on. Additionally, several `server_name` parameters can be specified via the query parameters. The post body accepts an optional string parameter, `reason`, which is the reason you want to join the room. A request could look as follows: @@ -214,6 +211,9 @@ Content-Type: application/json } ``` +This endpoint requires authentication and can be rate limited. + + #### Responses: ##### Status code 200: The user knocked successfully. Example reply: