documented REST endpoints and json schema