{"action":"opened","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11214","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11214/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11214/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11214/events","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/11214","id":94890633,"number":11214,"title":"API doc (swagger) doesn't mention which fields are optional","user":{"login":"marekbiskup","id":11961560,"avatar_url":"https://avatars.githubusercontent.com/u/11961560?v=3","gravatar_id":"","url":"https://api.github.com/users/marekbiskup","html_url":"https://github.com/marekbiskup","followers_url":"https://api.github.com/users/marekbiskup/followers","following_url":"https://api.github.com/users/marekbiskup/following{/other_user}","gists_url":"https://api.github.com/users/marekbiskup/gists{/gist_id}","starred_url":"https://api.github.com/users/marekbiskup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/marekbiskup/subscriptions","organizations_url":"https://api.github.com/users/marekbiskup/orgs","repos_url":"https://api.github.com/users/marekbiskup/repos","events_url":"https://api.github.com/users/marekbiskup/events{/privacy}","received_events_url":"https://api.github.com/users/marekbiskup/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/kind/documentation","name":"kind/documentation","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-07-14T08:09:21Z","updated_at":"2015-07-14T08:09:21Z","closed_at":null,"body":"I wonder if it is possible to include the information about which fields are optional into swagger. Maybe as annotations.\r\n\r\nThere is such documentation for GKE:\r\nhttps://cloud.google.com/container-engine/docs/spec-schema\r\nBut I haven't found it for opensource Kubernetes."}}