Optional
descriptionA description of the link. CommonMark syntax MAY be used for rich text representation.
Optional
operationThe name of an existing, resolvable OAS operation, as defined with a
unique operationId
. This field is mutually exclusive of the
operationRef
field.
Optional
operationA relative or absolute URI reference to an OAS operation. This field is
mutually exclusive of the operationId
field, and MUST point to an
Operation
Object.
Relative operationRef
values MAY be used to locate an existing
Operation
Object in the
OpenAPI definition. See the rules for resolving Relative
References.
Optional
parametersA map representing parameters to pass to an operation as specified with
operationId
or identified via operationRef
. The key is the parameter
name to be used, whereas the value can be a constant or an expression to be
evaluated and passed to the linked operation. The parameter name can be
qualified using the parameter
location
[{in}.]{name}
for operations that use the same parameter name in
different locations (e.g. path.id).
Optional
requestA literal value or {expression} to use as a request body when calling the target operation.
Optional
serverA server object to be used by the target operation.
The
Link object
represents a possible design-time link for a response. The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.Unlike dynamic links (i.e. links provided in the response payload), the OAS linking mechanism does not require link information in the runtime response.
For computing links, and providing instructions to execute them, a runtime expression is used for accessing values in an operation and using them as parameters while invoking the linked operation.
A linked operation MUST be identified using either an
operationRef
oroperationId
. In the case of anoperationId
, it MUST be unique and resolved in the scope of the OAS document. Because of the potential for name clashes, theoperationRef
syntax is preferred for OpenAPI documents with external references.See
https://spec.openapis.org/oas/latest.html#link-object