matrix-spec/event-schemas/schema/v1/m.room.aliases

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "title": "Informs the room about what room aliases it has been given.",
    "description": "This event is sent by a homeserver directly to inform of changes
    to the list of aliases it knows about for that room. The
    ``state_key`` for this event is set to the homeserver which
    owns the room alias. The entire set of known aliases for the
    room is the union of all the ``m.room.aliases`` events, one
    for each homeserver. Clients **should** check the validity
    of any room alias given in this list before presenting it to
    the user as trusted fact. The lists given by this event
    should be considered simply as advice on which aliases
    might exist, for which the client can perform the lookup to
    confirm whether it receives the correct room ID.",
    "allOf": [{
        "$ref": "core#/definitions/state_event"
    }],
    "properties": {
        "content": {
            "type": "object",
            "properties": {
                "aliases": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            },
            "required": ["aliases"]
        },
        "type": {
            "type": "string",
            "enum": ["m.room.aliases"]
        }
    }
}