{"action":"created","issue":{"url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/146","labels_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/146/labels{/name}","comments_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/146/comments","events_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/146/events","html_url":"https://github.com/swagger-api/swagger-spec/issues/146","id":45420741,"number":146,"title":"Support for multiple request/response models based on headers","user":{"login":"jahlborn","id":689395,"avatar_url":"https://avatars.githubusercontent.com/u/689395?v=3","gravatar_id":"","url":"https://api.github.com/users/jahlborn","html_url":"https://github.com/jahlborn","followers_url":"https://api.github.com/users/jahlborn/followers","following_url":"https://api.github.com/users/jahlborn/following{/other_user}","gists_url":"https://api.github.com/users/jahlborn/gists{/gist_id}","starred_url":"https://api.github.com/users/jahlborn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jahlborn/subscriptions","organizations_url":"https://api.github.com/users/jahlborn/orgs","repos_url":"https://api.github.com/users/jahlborn/repos","events_url":"https://api.github.com/users/jahlborn/events{/privacy}","received_events_url":"https://api.github.com/users/jahlborn/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/swagger-api/swagger-spec/labels/Swagger.Next%20Proposal","name":"Swagger.Next Proposal","color":"207de5"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":37,"created_at":"2014-10-09T21:35:24Z","updated_at":"2015-04-28T08:57:17Z","closed_at":null,"body":"I guess this is a 2.0+ request as 2.0 is already \"released\".\r\n\r\nBasically, there is currently no way to express a single path which may have different request/response formats based on additional criteria, namely headers.  two possible scenarios:\r\n\r\n1. An API which supports both xml and json, but the models for each format are different enough that they cannot be expressed via a single json schema w/ xml annotations (even if the xml format _is_ expressible using the xml annotations).\r\n2. An API which supports versioning the representation via the media-type.  e.g. application/my+v1 returns a json model which is sufficiently different from the application/my+v2 model such that i cannot describe them both using one unified model.\r\n\r\nIf supporting different responses for arbitrary headers is too big of a change, just supporting multiple media-types (for request and response) would be sufficient for the cases described here.\r\n"},"comment":{"url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/comments/96981770","html_url":"https://github.com/swagger-api/swagger-spec/issues/146#issuecomment-96981770","issue_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/146","id":96981770,"user":{"login":"webron","id":241629,"avatar_url":"https://avatars.githubusercontent.com/u/241629?v=3","gravatar_id":"","url":"https://api.github.com/users/webron","html_url":"https://github.com/webron","followers_url":"https://api.github.com/users/webron/followers","following_url":"https://api.github.com/users/webron/following{/other_user}","gists_url":"https://api.github.com/users/webron/gists{/gist_id}","starred_url":"https://api.github.com/users/webron/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/webron/subscriptions","organizations_url":"https://api.github.com/users/webron/orgs","repos_url":"https://api.github.com/users/webron/repos","events_url":"https://api.github.com/users/webron/events{/privacy}","received_events_url":"https://api.github.com/users/webron/received_events","type":"User","site_admin":false},"created_at":"2015-04-28T08:57:17Z","updated_at":"2015-04-28T08:57:17Z","body":"Are we really going to continue back and forth on this? I didn't say it's a requirement for a proposal to be accepted. I said I'd *like to see* these things. And right after the bullets, I specifically said they are definitely not all required. There can even be one-line proposals that would be accepted.\r\n\r\nAnd this *is* the spec community. "}}