matrix-spec-proposals/event-schemas/schema/v1/m.room.member

{
    "type": "object",
    "title": "The current membership state of a user in the room.",
    "description": "Adjusts the membership state for a user in a room. It is preferable to use the membership APIs (``/rooms/<room id>/invite`` etc) when performing membership actions rather than adjusting the state directly as there are a restricted set of valid transformations. For example, user A cannot force user B to join a room, and trying to force this state change directly will fail. The ``third_party_invite`` property will be set if the invite was an ``m.room.third_party_invite`` event, and absent if the invite was an ``m.room.member`` event.",
    "allOf": [{
        "$ref": "core-event-schema/state_event.json"
    }],
    "properties": {
        "content": {
            "type": "object",
            "properties": {
                "membership": {
                    "type": "string",
                    "description": "The membership state of the user.",
                    "enum": ["invite","join","knock","leave","ban"]
                },
                "avatar_url": {
                    "type": "string",
                    "description": "The avatar URL for this user, if any. This is added by the homeserver."
                },
                "displayname": {
                    "type": ["string", "null"],
                    "description": "The display name for this user, if any. This is added by the homeserver."
                },
                "third_party_invite": {
                    "type": "object",
                    "title": "invite",
                    "properties": {
                        "token": {
                            "type": "string",
                            "description": "A token which must be correctly signed, in order to join the room."
                        },
                        "key_validity_url": {
                            "type": "string",
                            "description": "A URL which can be fetched, with querystring ``public_key=public_key``, to validate whether the key has been revoked. The URL must return a JSON object containing a boolean property named 'valid'."
                        },
                        "public_key": {
                            "type": "string",
                            "description": "A base64-encoded ed25519 key with which token must be signed."
                        },
                        "signature": {
                            "type": "string",
                            "description": "A base64-encoded signature of token with public_key."
                        },
                        "sender": {
                            "type": "string",
                            "description": "The matrix user ID of the user who send the invite which is being used."
                        }
                    },
                    "required": ["token", "key_validity_url", "public_key", "signature", "sender"]
                }
            },
            "required": ["membership"]
        },
        "state_key": {
            "type": "string",
            "description": "The ``user_id`` this membership event relates to."
        },
        "type": {
            "type": "string",
            "enum": ["m.room.member"]
        },
        "invite_room_state": {
            "type": "array",
            "description": "A subset of the state of the room at the time of the invite, if ``membership`` is ``invite``",
            "items": {
                "type": "object",
                "title": "StateEvent",
                "description": "A stripped down state event, with only the ``type``, ``state_key`` and ``content`` keys.",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "state_key": {
                        "type": "string"
                    },
                    "content": {
                        "type": "object"
                    }
                }
            }
        }
    }
}