improve codex doc and responses
add multipurpose GET things endpoint to cater for diverse API's