Skip to content

Conversation

handrews
Copy link
Member

While working on cookie-related style changes, I noticed that we are unclear on how style defaulting works for the Encoding Object. Specifically, in 3.1.1 we clarified that all of style, explode, and allowReserved apply when any of those three are explicitly present. Otherwise, contentType applies (even if it is absent- its defaults apply).

So the default behavior for style takes place if either of the other two fields are there, but not if none of them are there (whether contentType is there or not).
This requires some rather complex schema changes and tests, which have not been done yet.

On the one hand, this is a clarification and should probably be backported to 3.1.2. On the other hand, it has schema changes, but more in the "we got the schema wrong" sense than in the "we're changing what was expected." I'm not entirely sure what to do with this for 3.1.2.

  • schema changes are included in this pull request
  • schema changes are needed for this pull request but not done yet
  • no schema changes are needed for this pull request

@handrews handrews added this to the v3.2.0 milestone Aug 21, 2025
@handrews handrews requested review from a team as code owners August 21, 2025 15:17
@handrews handrews added the media and encoding Issues regarding media type support and how to encode data (outside of query/path params) label Aug 21, 2025
@ralfhandl ralfhandl requested a review from a team August 21, 2025 16:18
Copy link
Contributor

@lornajane lornajane left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Helpful clarification, thanks.

@lornajane lornajane merged commit a83ae2a into OAI:v3.2-dev Aug 21, 2025
2 checks passed
handrews added a commit that referenced this pull request Aug 26, 2025
v3.1.2 Backport PR #4899 Encoding style default behavior
@handrews handrews deleted the enc-style-defaults branch August 27, 2025 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
media and encoding Issues regarding media type support and how to encode data (outside of query/path params)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants