{"action":"created","issue":{"url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/321","labels_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/321/labels{/name}","comments_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/321/comments","events_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/321/events","html_url":"https://github.com/swagger-api/swagger-spec/issues/321","id":66464465,"number":321,"title":"Clarify if header is required to be sent in the response","user":{"login":"Maks3w","id":1301698,"avatar_url":"https://avatars.githubusercontent.com/u/1301698?v=3","gravatar_id":"","url":"https://api.github.com/users/Maks3w","html_url":"https://github.com/Maks3w","followers_url":"https://api.github.com/users/Maks3w/followers","following_url":"https://api.github.com/users/Maks3w/following{/other_user}","gists_url":"https://api.github.com/users/Maks3w/gists{/gist_id}","starred_url":"https://api.github.com/users/Maks3w/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Maks3w/subscriptions","organizations_url":"https://api.github.com/users/Maks3w/orgs","repos_url":"https://api.github.com/users/Maks3w/repos","events_url":"https://api.github.com/users/Maks3w/events{/privacy}","received_events_url":"https://api.github.com/users/Maks3w/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/swagger-api/swagger-spec/labels/2.0","name":"2.0","color":"009800"},{"url":"https://api.github.com/repos/swagger-api/swagger-spec/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":{"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},"milestone":null,"comments":5,"created_at":"2015-04-05T17:52:40Z","updated_at":"2015-04-10T09:37:53Z","closed_at":null,"body":"Given the headers section has a definition for a given header (let's say ETag) the question is:\r\n\r\nIs the header required to be present in the response sent by the server?\r\n\r\n> headers: A list of headers **that are sent** with the response.\r\n> https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#fixed-fields-10\r\n\r\n> Headers object: Lists the headers that **can be** sent as part of a response.\r\n> https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#headersObject\r\n\r\nReading the first definition I understand that is *REQUIRED*.\r\nReading the second definition I understand that is *OPTIONAL*.\r\n\r\nSpec should be rephrased clarifying this aspect."},"comment":{"url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/comments/91494779","html_url":"https://github.com/swagger-api/swagger-spec/issues/321#issuecomment-91494779","issue_url":"https://api.github.com/repos/swagger-api/swagger-spec/issues/321","id":91494779,"user":{"login":"nfroidure","id":229633,"avatar_url":"https://avatars.githubusercontent.com/u/229633?v=3","gravatar_id":"","url":"https://api.github.com/users/nfroidure","html_url":"https://github.com/nfroidure","followers_url":"https://api.github.com/users/nfroidure/followers","following_url":"https://api.github.com/users/nfroidure/following{/other_user}","gists_url":"https://api.github.com/users/nfroidure/gists{/gist_id}","starred_url":"https://api.github.com/users/nfroidure/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nfroidure/subscriptions","organizations_url":"https://api.github.com/users/nfroidure/orgs","repos_url":"https://api.github.com/users/nfroidure/repos","events_url":"https://api.github.com/users/nfroidure/events{/privacy}","received_events_url":"https://api.github.com/users/nfroidure/received_events","type":"User","site_admin":false},"created_at":"2015-04-10T09:37:53Z","updated_at":"2015-04-10T09:37:53Z","body":"What about a required=true attribute in the headers object definition?\r\nhttps://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#headersObject\r\n\r\nI think it strongly depends on each headers type."}}