docs: API documentation
api: rename flags to json_flags