clarify expected response from server in docs