Start the requesting user participating in a particular room.

POST {{baseUrl}}/rooms/:roomId/join

Note that this API requires a room ID, not alias. /join/{roomIdOrAlias} exists if you have a room alias.

This API starts a user participating in a particular room, if that user is allowed to participate in that room. After this call, the client is allowed to see all current state events in the room, and all subsequent events associated with the room until the user leaves the room.

After a user has joined a room, the room will appear as an entry in the response of the /initialSync and /sync APIs.

Request Body

{"third_party_signed"=>{"value"=>"reference definitions/third_party_signed.yaml not found in the OpenAPI spec"}, "reason"=>"Looking for support"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"room_id":"!d41d8cd:matrix.org"}