matrix-spec/data/event-schemas/schema
Travis Ralston f97d2944ae
Some checks failed
Spec / 🔎 Validate OpenAPI specifications (push) Has been cancelled
Spec / 🔎 Check Event schema examples (push) Has been cancelled
Spec / 🔎 Check OpenAPI definitions examples (push) Has been cancelled
Spec / 🔎 Check JSON Schemas inline examples (push) Has been cancelled
Spec / ⚙️ Calculate baseURL for later jobs (push) Has been cancelled
Spec / 📢 Run towncrier for changelog (push) Has been cancelled
Spell Check / Spell Check with Typos (push) Has been cancelled
Spec / 🐍 Build OpenAPI definitions (push) Has been cancelled
Spec / 📖 Build the spec (push) Has been cancelled
Spec / 🔎 Validate generated HTML (push) Has been cancelled
Spec / 📖 Build the historical backup spec (push) Has been cancelled
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)
2025-08-14 11:16:00 -06:00
..
components Spec PR - MSC3765: Rich text in room topics (#2095) 2025-05-13 16:01:25 +01:00
core-event-schema Fix new redocly lints (#2182) 2025-07-29 17:22:26 +00:00
m.accepted_terms.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.call.answer.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.candidates.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.hangup.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.invite.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.negotiate.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.reject.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.sdp_stream_metadata_changed.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.call.select_answer.yaml Sort VoIP events semantically (#1967) 2024-10-15 17:22:40 +01:00
m.direct.yaml Use patternProperties in more places with supported formats (#1813) 2024-05-08 13:59:17 +00:00
m.dummy.yaml Fix links in data 2021-08-27 19:16:42 +01:00
m.forwarded_room_key.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.fully_read.yaml Remove 'room_id' field from m.typing, m.receipt and m.fully_read examples and schema (#3679) 2022-05-09 01:28:17 -06:00
m.identity_server.yaml Clarify formats of string types in account sections (#2046) 2025-01-17 17:18:51 +00:00
m.ignored_user_list.yaml Add support for pattern formats for patternProperties (#1796) 2024-04-24 12:42:34 +01:00
m.key.verification.accept.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.cancel.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.done.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.key.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.m.relates_to.yaml Spec reference relationships (#1206) 2022-10-18 11:50:41 -06:00
m.key.verification.mac.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.ready.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.request.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.key.verification.start$m.reciprocate.v1.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.start$m.sas.v1.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.key.verification.start.yaml Clean up unecessary allOfs (#1797) 2024-04-23 17:07:24 +01:00
m.marked_unread.yaml Spec for MSC2867 (Marking rooms as unread) (#1895) 2024-07-15 14:38:57 +01:00
m.policy.rule.room.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.policy.rule.server.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.policy.rule.user.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.presence.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.push_rules.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.reaction.yaml Add missing type enum for m.reaction (#1552) 2023-07-04 12:52:48 +00:00
m.receipt.yaml Add support for pattern formats for patternProperties (#1796) 2024-04-24 12:42:34 +01:00
m.room.avatar.yaml Clarify that room avatars cannot be encrypted (#1871) 2024-06-25 15:40:21 +01:00
m.room.canonical_alias.yaml Change RST code formatting markup to Markdown 2021-08-27 19:16:42 +01:00
m.room.create.yaml Room version 12 (#2193) 2025-08-14 11:16:00 -06:00
m.room.encrypted.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.room.encryption.yaml Change RST code formatting markup to Markdown 2021-08-27 19:16:42 +01:00
m.room.guest_access.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.room.history_visibility.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.room.join_rules.yaml Add knock_restricted to m.room.join_rules enum (#1535) 2023-05-23 13:40:32 -06:00
m.room.member.yaml Clarifications around third-party invites (#2083) 2025-04-22 15:48:50 +01:00
m.room.message$m.audio.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.emote.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.file.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.image.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.key.verification.request.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.location.yaml Fix m.location.yaml scheme (#1507) 2023-05-02 12:02:05 -04:00
m.room.message$m.notice.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.server_notice.yaml Change RST code formatting markup to Markdown 2021-08-27 19:16:42 +01:00
m.room.message$m.text.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message$m.video.yaml Clarify that format is required if formatted_body is specified (#2167) 2025-07-15 11:47:50 +03:00
m.room.message.yaml Change RST code formatting markup to Markdown 2021-08-27 19:16:42 +01:00
m.room.name.yaml Clarify that an m.room.name event with an absent name field is not expected behavior (#1639) 2023-09-19 15:39:07 +01:00
m.room.pinned_events.yaml Move raw API and event schemas into /data directory 2021-08-27 19:16:39 +01:00
m.room.power_levels.yaml Room version 12 (#2193) 2025-08-14 11:16:00 -06:00
m.room.redaction.yaml Add room version 11 (#1604) 2023-08-15 00:18:45 -06:00
m.room.server_acl.yaml Clarify what key content-specific rules match against. (#1441) 2023-03-08 13:06:06 +00:00
m.room.third_party_invite.yaml Clarifications around third-party invites (#2083) 2025-04-22 15:48:50 +01:00
m.room.tombstone.yaml Explicitly call replacement_room a room ID 2021-08-27 19:17:14 +01:00
m.room.topic.yaml Spec PR - MSC3765: Rich text in room topics (#2095) 2025-05-13 16:01:25 +01:00
m.room_key.withheld.yaml fix typos in m.room_key.withheld (#2080) 2025-02-25 17:11:50 -05:00
m.room_key.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.room_key_request.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.secret.request.yaml Apply suggestions from code review 2022-11-15 18:17:20 -05:00
m.secret.send.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.space.child.yaml Fix relative URLs when serving the specification with a custom baseURL (#1984) 2024-11-14 11:11:34 +00:00
m.space.parent.yaml Clarify that via is required for m.space.parent and m.space.child as per MSC1772. (#1618) 2023-09-05 15:29:54 +01:00
m.sticker.yaml Change RST code formatting markup to Markdown 2021-08-27 19:16:42 +01:00
m.tag.yaml Factor out common definition of Tag type (#1793) 2024-04-17 13:51:24 +01:00
m.typing.yaml Remove 'room_id' field from m.typing, m.receipt and m.fully_read examples and schema (#3679) 2022-05-09 01:28:17 -06:00