document JSON schemas
revise JSON schemas below
doc/schema
link JSON schemas in
api_endpoints.md
where appropriate
write
schema overview