Discussion regarding the complex response structure for REST & GraphQL (Developer Experience)

it’s helpful but you should update error messages and method comments, for clear explanation of arguments to be passed in a methods