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/data/api/server-server
Travis Ralston f97d2944ae
Room version 12 (#2193)
* Placeholder

* i++

* Room version 12

Template out a v12 room version

Make v12 default, per MSC4304

Update PDU checks and auth event selection per MSC4291

Describe new room_id format per MSC4291

Move v6 depth definition to a component for easier referencing

Move room_id to a component to prep for v12, per MSC4291

Create and use a new room_id component for v12+ per MSC4291

Reflect auth events selection change onto all room versions per MSC4291

The MSC asks the `description` of `auth_events` to be adjusted, however this feels like a better representation of the change.

Add `room_id` format rules and renumber per MSC4291

Reflect change to rule 1.2 per MSC4291

Insert same room_id check to v1-12 auth rules per MSC4307 and MSC4291

Deprecate `predecessor.event_id` per MSC4291

Insert auth rule to validate `additional_creators` per MSC4289

Insert rule for `users` validation of creators and renumber per MSC4289

Define "room creator(s)" per MSC4289

Spec `additional_creators` on create events per MSC4289

Spec `additional_creators` on `/upgrade` per MSC4289

The MSC doesn't mention how to handle unsupported room versions, but the Synapse implementation used for FCP ignores the field in such room versions. This feels like a good approach, and will need clarifying in the MSC too (if accepted at the spec level).

Add notes to `/upgrade` behaviour per MSC4289 and MSC4291

Describe how additional creators work during room creation per MSC4289

Fix default user power level descriptions per MSC4289

Describe tombstone power level changes per MSC4289

Warn clients about event format changes in v12 per MSC4289 and MSC4291

Flag additional room creators support for client reference per MSC4289

Remove TODO now that it's fully addressed

Copy state res into v12 as-is for modification

Apply Modification 1 to SR2.1 per MSC4297

Apply Modification 2 to SR2.1 per MSC4297

Add summary box to the top of SR2.1 for ease of developer reference

Modification 2 was split into items 2 and 3 for further ease of understanding.

Add all the changelogs

`x` is used until a real PR number can be assigned.

Some changelogs are duplicated to the Client-Server API to increase visibility of the changes to v12.

Review: Minor phrasing adjustments in changelogs

Review: Clarify that v12 isn't quite the default yet in the changelog

Review: Clarify to clients that creators are immutable

Review: Improve 'how to parse a domain' advice for legacy apps

Review: Add a bit more detail as to why a room ID might be required

Apply suggestions from code review

Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>

Clarify that clients can override the tombstone default

Mention creatorship UI label by finishing the Permissions section

We probably should have removed the WIP note in v1.0, but alas.

Add changelog for tombstone changes

Use assigned spec PR number in changelogs

(cherry picked from commit ec81eea7e4532fd398b8013071d6981c97117d9e)
4 months ago
..
definitions Room version 12 (#2193) 4 months ago
examples Room version 12 (#2193) 4 months ago
backfill.yaml Fix security schemes in OpenAPI definitions (#1772) 2 years ago
content_repository.yaml Replace references to obsolete RFC 1341 with RFC 2046 (#1869) 1 year ago
event_auth.yaml Fix security schemes in OpenAPI definitions (#1772) 2 years ago
events.yaml Fix relative URLs when serving the specification with a custom `baseURL` (#1984) 1 year ago
invites-v1.yaml Add a note to the federation invite endpoints that invites can be sent twice (#2067) 7 months ago
invites-v2.yaml Add a note to the federation invite endpoints that invites can be sent twice (#2067) 7 months ago
joins-v1.yaml Remove the `origin` field in `PUT /send_join` responses (#2050) 11 months ago
joins-v2.yaml Look for examples in all possible locations (#2076) 9 months ago
keys_query.yaml Use "server name" instead of "DNS name" to avoid confusion (#1946) 1 year ago
keys_server.yaml Upgrade Swagger data to OpenAPI 3.1 (#1310) 3 years ago
knocks.yaml Look for examples in all possible locations (#2076) 9 months ago
leaving-v1.yaml Fix security schemes in OpenAPI definitions (#1772) 2 years ago
leaving-v2.yaml Fix security schemes in OpenAPI definitions (#1772) 2 years ago
openid.yaml Upgrade Swagger data to OpenAPI 3.1 (#1310) 3 years ago
public_rooms.yaml Clarify the meaning of "public rooms" in the room directory (#2104) 7 months ago
query.yaml MSC4170: 403 error responses for profile APIs (#1867) 1 year ago
space_hierarchy.yaml Spec PR - MSC3266: Room Summary API (#2125) 6 months ago
third_party_invite.yaml Clarifications around third-party invites (#2083) 8 months ago
transactions.yaml Use `patternProperties` in more places with supported formats (#1813) 2 years ago
user_devices.yaml Fix security schemes in OpenAPI definitions (#1772) 2 years ago
user_keys.yaml Specify the order in which one-time keys are returned (MSC4225) (#2029) 12 months ago
version.yaml Upgrade Swagger data to OpenAPI 3.1 (#1310) 3 years ago
wellknown.yaml Clarify Well-Known URIs (#2140) 7 months ago