With api-methods design guidelines, we need to see raw inputs and responses, properly formatted requests with examples and cURL