matrix-spec/data/event-schemas/schema/m.room.canonical_alias.yaml
Kévin Commaille d601884378
Clarify string formats of event endpoints and schemas
Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
2026-03-30 17:58:24 +02:00

41 lines
1.2 KiB
YAML

---
$schema: https://json-schema.org/draft/2020-12/schema
allOf:
- $ref: core-event-schema/state_event.yaml
description: |-
This event is used to inform the room about which alias should be
considered the canonical one, and which other aliases point to the room.
This could be for display purposes or as suggestion to users which alias
to use to advertise and access the room.
properties:
content:
properties:
alias:
description: |
The canonical alias for the room. If not present, null, or empty the
room should be considered to have no canonical alias.
type: string
format: mx-room-alias
pattern: "^#"
alt_aliases:
description: |
Alternative aliases the room advertises. This list can have aliases
despite the `alias` field being null, empty, or otherwise not present.
type: array
items:
type: string
format: mx-room-alias
pattern: "^#"
type: object
state_key:
description: A zero-length string.
pattern: '^$'
type: string
type:
enum:
- m.room.canonical_alias
type: string
title: Informs the room as to which alias is the canonical one.
type: object