(refactor) exposed api endpoint allowing passage of encoded json

... be rendered