The members of the OpenAPI Initiative Technical Steering Committee have announced the latest release of OpenAPI Specification 3.0.2. Note: This release is a patch release and none of these modifications change the behavior of the spec.
As a patch release, the latest changes were made to improve the specification in terms of readability and accuracy. Please read the release notes on on our GitHub repo here.
If you are interested in getting involved in the development of the spec, join us Thursday’s at 9a.m. Pacific for the public, open meetings of the Technical Steering Committee.
- Added clarification to case sensitivity of keys in maps.
- Reworked the Data Type table, removing the Common Name to reduce potential confusion.
- Clarified the description of the Server Variable Object’s default field.
- Fixed various examples.
- Clarified operationId is case sensitive.
- Clarified the default value of the Parameter Object’s deprecated field is false.
- Added recommendation to not use the Parameter Object’s allowEmptyValue field as it will be removed in a future version.
- Fixed the description of the Media Type Object’s schema field.
- Clarified the description of the Responses Object’s response codes field description.
- Clarified that the Schema Object’s additionalProperties field has a default value of true.
- Fixed a small wording issue in the Discriminator Object description.
- Fixed the Security Scheme Object description to include reference to the use of API Keys in cookies.
- Fixed the description of the Security Requirement Object.
Join the OpenAPI Initiative and hundreds of API developers, strategist and thought leaders for 
Cristiano is a Developer Experience designer who helps companies small and large to improve their developer onboarding, activation, and support. He likes to look at great developer onboarding flows, analysing and documenting the best practices and pitfalls of common design practices. Although he has over 15 years of development experience he believes that at the core we’re all beginners at some things, and documentation and onboarding should reflect that notion. In the past he’s worked as a contractor, startup founder, event organiser, and developer advocate at PayPal.
Virginia Eubanks is an Associate Professor of Political Science at the University at Albany, SUNY. She is the author of Automating Inequality: How High-Tech Tools Profile, Police, and Punish the Poor; Digital Dead End: Fighting for Social Justice in the Information Age; and co-editor, with Alethia Jones, of Ain’t Gonna Let Nobody Turn Me Around: Forty Years of Movement Building with Barbara Smith. Her writing about technology and social justice has appeared in The American Prospect, The Nation, Harper’s and Wired. For two decades, Eubanks has worked in community technology and economic justice movements. Today, she is a founding member of the Our Data Bodies Project and a Fellow at New America. She lives in Troy, NY.
Kate O’Neill, “tech humanist,” is founder and CEO of KO Insights, an award-winning thought leadership and advisory firm helping companies, organizations, and cities make future-aligned meaningful decisions based on human behavior and data. Author of 3 books including PIXELS AND PLACE: Connecting Human Experience Across Physical and Digital Spaces, Kate speaks regularly at industry conferences and private events, providing keynotes, participating in panel discussions, and leading creative brainstorming workshops for groups of all sizes. Her expertise has been featured in CNN Money, TIME, Forbes, USA Today, Men’s Journal, the BBC, and other national and international media. Kate’s prior roles include creating the first content management role at Netflix, leading cutting-edge online optimization work at Magazines.com, developing Toshiba America’s first intranet, building the first departmental website at the University of Illinois at Chicago, and holding leadership positions in a variety of digital content and technology start-ups. She was also founder & CEO of [meta]marketer, a digital strategy and analytics agency. Kate is a vocal and visible advocate for women in technology, entrepreneurship, and leadership — she was featured by Google in the launch of their global campaign for women in entrepreneurship.