You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec/proposals/2414-optional-content-repor...

952 B

MSC2414: Make reason optional for reporting content

Currently, the spec says that the reason parameter on the content reporting endpoint is required, but also says that the string "may be blank." This seems to be a contradiction.

This MSC proposes that the required flag for this parameter be removed, as well as the "may be blank" clause in the description.

Note that the kicking and banning endpoints already have optional reason parameters. The other endpoints mentioned in #2367 will also add optional reason parameters, so it seems that it would be more more consistent with the rest of the spec to make this optional as well.

Backwards Compatibility

Since servers currently expect this field to be sent by all clients, making this optional is a breaking change. Clients should send query the version of the homeserver to determine whether they can safely omit this field.