"path parameters MUST NOT contain any unescaped “generic syntax” characters"

[karenetheridge]

at https://spec.openapis.org/oas/v3.1.0#path-templating:

The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [RFC3986]: forward slashes (/), question marks (?), or hashes (#).

Is this referring to the name of the path parameter, or the value itself?

For example, for the path template /pets/{petId}, is it "petId" itself (which is the name clause in the parameter specification) that cannot contain these characters -- that is, a restriction on the openapi document itself? or is it the value of this parameter, at runtime, that cannot contain these characters, for example "cat_01" in the URI /pets/cat_01?

Either way, the language in the specification here could do with a little tightening.

This question has also come up in #2564.

[hkosova]

Is this referring to the name of the path parameter, or the value itself?

The value itself. See #291 and #892#issuecomment-281170254. This sentence was added to indicate that the value of a path parameter cannot result in additional path segments.

[hkosova]

I wonder if the names of path parameters are supposed to be restricted to the varname ABNF from RFC 6570, URI Template. OAS itself currently places no restrictions on path parameter names so technically a space " " can be considered be a valid name.

[karenetheridge]

In that case, commit ce732af should be reverted, and possibly replaced with something else - even if just ^[^}]+$ (the name of path parameters can be anything as long as it doesn't contain a closing curly brace -- or are escaped curlies allowed in a path name?).

(I see quite a lot of discussion in old tickets about supporting more of the RFC 6570 syntax in the path specification -- I hope it is still under consideration!)

[handrews]

@karenetheridge did PR #3415 getting merged address everything for this issue?

[github-actions]

This issue has been labeled with No recent activity because there has been no recent activity. It will be closed if no further activity occurs within 28 days. Please re-open this issue or open a new one after this delay if you need to.