matrix-spec/event-schemas/schema/m.room.canonical_alias
Richard van der Hoff d4194dd24e Clarify the room-naming behaviour
Make behaviour on empty `m.room.name` and `m.room.canonical_alias` events
explicit.
2016-07-11 17:49:27 +01:00

31 lines
849 B
Plaintext

---
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. This could be for display purposes or as
suggestion to users which alias to use to advertise the room.
A room with an ``m.room.canonical_alias`` event with an empty or absent
``alias`` field should be treated the same as a room with no
``m.room.canonical_alias`` event.
properties:
content:
properties:
alias:
description: The canonical alias.
type: string
type: object
required:
- alias
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