Optional
componentsOptional
deprecatedOptional
descriptionadd a description to this operation
Optional
externaladd an external documentation to this operation
Optional
operationadd an operation id to this operation
Optional
parametersallow to pass header or cookies parameters
Optional
pathallow to bypass the query generation from params . Specify it yourself
Optional
queryallow to bypass the query generation from params . Specify it yourself
Optional
requestallow to bypass the generation from params . Specify it yourself
Optional
responsecan be used to fastly declare the 200 answer can be directly a Media Type Object so it will reuse the default contentType or an object specifying the type and the media
Optional
responsesspecify all responses of the operation . Merged by levels
Optional
securityspecify the security needed to call this endpoint
Optional
serversadd a list of servers to this operation
Optional
summaryadd a summary to this operation
Optional
tagsAllow to define tags of the https://spec.openapis.org/oas/v3.1.0#operation-object|Operation
tags are unique in all the openApi, and identified by his name . Defining two times the same tag will merge them
// setting tags to all children
{
tags: ['tags1', 'tags2']
}
// remove parents tags, and set tags to children
{
tags: [null, 'tags3', 'tags4']
}
// add tag with description, and use it on children
{
tags: [
{
name: "tags1";
description: "this is the first example tag";
externalDocs: "https://doc.example.com/tags/tags1";
},
'tags1'
]
}
set this endpoint as deprecated