Core API message.json description does not reflect the reality of the API

The Core API message.json file at app/Plugin/CoreApi/Config/Schema/message.json does not accurately reflect how the API actually works.

For example, the API will often return the ID for an object as a JSON string (e.g. "23") rather than a JSON integer (e.g. 23).

There are also some details missing, for example the EmailAddress JSON object does not have a "description" property.