The id MUST be unique among all operations described in the API. The operationId value is case-sensitive. Tools
and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow
common programming naming conventions.
A list of parameters that are applicable for this operation.
If a parameter is already defined at the Path Item, the new definition will override it but can never remove it.
The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a name and
location. The list can use the Reference Object to link to parameters that are defined at the OpenAPI Object's
components/parameters.
The requestBody is only supported in HTTP methods where the HTTP 1.1 specification RFC7231 has explicitly defined
semantics for request bodies. In other cases where the HTTP spec is vague, requestBody SHALL be ignored by
consumers.
The list of possible responses as they are returned from executing this operation.
Any HTTP status code can be used as the property name, but only one property per code, to describe the expected
response for that HTTP statuscode. You can use const values of HTTPResponse for this, eg.
[HTTPResponse.OK] { ... }
A Reference Object can link to a response that is defined in the OpenAPI
Object's components/responses section. To define a range of response codes, this field MAY contain the uppercase
wildcard character X. For example, 2XX represents all response codes between 200-299. Only the following range
definitions are allowed: 1XX, 2XX, 3XX, 4XX, and 5XX. If a response is defined using an explicit code, the explicit
code definition takes precedence over the range definition for that code.
A map of possible out-of band callbacks related to the parent operation.
The key is a unique identifier for the Callback Object. Each value in the map is a Callback Object that describes a
request that may be initiated by the API provider and the expected responses.
A declaration of which security mechanisms can be used for this operation.
The list of values includes alternative security requirement objects that can be used. Only one of the security
requirement objects need to be satisfied to authorize a request. To make security optional, an empty security
requirement ({}) can be included in the array. This definition overrides any declared top-level security. To
remove a top-level security declaration, an empty array can be used.
Returns the relative, descendent directory path between this module and other.
Throws if no such path exists.
For example, if module mod1 has path /dir1/mod1.pkl, and module mod2 has path /dir1/dir2/dir3/mod2.pkl,
then mod1.relativePathTo(mod2) will return List("dir2", "dir3").
A common use case is to compute the directory path between a template located at the root of a hierarchy
(say rootModule.pkl) and the currently evaluated module (accessible via the module keyword):
Describes a single API operation on a path.