{"action":"created","issue":{"url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/119","labels_url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/119/labels{/name}","comments_url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/119/comments","events_url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/119/events","html_url":"https://github.com/noirbizarre/flask-restplus/issues/119","id":127147034,"number":119,"title":"Add ability to document response headers","user":{"login":"awiddersheim","id":3237256,"avatar_url":"https://avatars.githubusercontent.com/u/3237256?v=3","gravatar_id":"","url":"https://api.github.com/users/awiddersheim","html_url":"https://github.com/awiddersheim","followers_url":"https://api.github.com/users/awiddersheim/followers","following_url":"https://api.github.com/users/awiddersheim/following{/other_user}","gists_url":"https://api.github.com/users/awiddersheim/gists{/gist_id}","starred_url":"https://api.github.com/users/awiddersheim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/awiddersheim/subscriptions","organizations_url":"https://api.github.com/users/awiddersheim/orgs","repos_url":"https://api.github.com/users/awiddersheim/repos","events_url":"https://api.github.com/users/awiddersheim/events{/privacy}","received_events_url":"https://api.github.com/users/awiddersheim/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-01-18T03:26:01Z","updated_at":"2016-01-27T12:51:20Z","closed_at":null,"body":"The library has the ability to quickly document the expected [request headers](https://flask-restplus.readthedocs.org/en/stable/documenting.html#headers) but currently there is not greay way to document the response headers. There was some stuff added in https://github.com/noirbizarre/flask-restplus/commit/a2b73da8d3023cf9450ecc320a6eb1c8f79bb9d6 to be able to do it but only with error handlers.\r\n\r\nI was thinking the best place to do it would be in [`response()`](https://github.com/noirbizarre/flask-restplus/blob/master/flask_restplus/namespace.py#L253). \r\n\r\nSeems like it might be better to convert responses to a `dict` rather than a `tuple` which has to get unpacked and makes this a bit difficult.\r\n\r\nPerhaps this is part of the *todo* planned:\r\n\r\nhttps://github.com/noirbizarre/flask-restplus/blob/master/flask_restplus/swagger.py#L384"},"comment":{"url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/comments/175603447","html_url":"https://github.com/noirbizarre/flask-restplus/issues/119#issuecomment-175603447","issue_url":"https://api.github.com/repos/noirbizarre/flask-restplus/issues/119","id":175603447,"user":{"login":"awiddersheim","id":3237256,"avatar_url":"https://avatars.githubusercontent.com/u/3237256?v=3","gravatar_id":"","url":"https://api.github.com/users/awiddersheim","html_url":"https://github.com/awiddersheim","followers_url":"https://api.github.com/users/awiddersheim/followers","following_url":"https://api.github.com/users/awiddersheim/following{/other_user}","gists_url":"https://api.github.com/users/awiddersheim/gists{/gist_id}","starred_url":"https://api.github.com/users/awiddersheim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/awiddersheim/subscriptions","organizations_url":"https://api.github.com/users/awiddersheim/orgs","repos_url":"https://api.github.com/users/awiddersheim/repos","events_url":"https://api.github.com/users/awiddersheim/events{/privacy}","received_events_url":"https://api.github.com/users/awiddersheim/received_events","type":"User","site_admin":false},"created_at":"2016-01-27T12:51:20Z","updated_at":"2016-01-27T12:51:20Z","body":"Yeah, that makes sense to me as well. Pretty large breaking change though obviously."}}