matrix-spec/data/event-schemas/schema/m.room.message$m.key.verification.request.yaml

---
allOf:
  - $ref: core-event-schema/room_event.yaml
description:
  Requests a key verification in a room.  When requesting a key verification
  using to-device messaging, an event with type [`m.key.verification.request`](/client-server-api/#mkeyverificationrequest)
  should be used.
properties:
  content:
    properties:
      body:
        type: string
        description: |-
          A fallback message to alert users that their client does not support
          the key verification framework, and that they should use a different method
          to verify keys.  For example, "Alice is requesting to verify keys with you.
          However, your client does not support this method, so you will need to use
          the legacy method of key verification."

          Clients that do support the key verification framework should hide the body
          and instead present the user with an interface to accept or reject the key
          verification.
      format:
        description: |-
          The format used in the `formatted_body`. Currently only
          `org.matrix.custom.html` is supported.
        type: string
      formatted_body:
        description: |-
          The formatted version of the `body`. This is required if `format` is
          specified.  As with the `body`, clients that do support the key
          verification framework should hide the formatted body and instead
          present the user with an interface to accept or reject the key
          verification.
        type: string
      from_device:
        type: string
        description: |-
          The device ID which is initiating the request.
      methods:
        type: array
        description: |-
          The verification methods supported by the sender.
        items:
          type: string
      to:
        description: |-
          The user that the verification request is intended for.  Users who
          are not named in this field and who did not send this event should
          ignore all other events that have an `m.reference` relationship with
          this event.
        type: string
      msgtype:
        enum:
          - m.key.verification.request
        type: string
    required:
      - from_device
      - methods
      - msgtype
      - to
    type: object
  type:
    enum:
      - m.room.message
    type: string
title: KeyVerification
type: object