So my first thought is we should be using JSON Schema officially to describe the JSON structure.
for those not familiar:
https://json-schema.org/learn/getting-started-step-by-step
The rationale is that it will be far easier to implement these entities/structures if they are described in JSON schema vs plain JSON.
The work put into the scheme can then be later used programmatically to generate entities etc.
@jordan-evens, you may be doing this already, but if not I am asking if we should do it moving forward.