Skip to content

[T] OpenAPI3Operation

type OpenAPI3Operation = Extensions & object;

An operation attached to an HTTP method on a path, with its inputs, responses and security overrides.

NameTypeDescription
deprecated?booleanMarks an operation that consumers should stop using; absence means false.
description?stringDetailed explanation of the operation, which may use CommonMark.
operationId?stringIdentifier that must be unique among operations in the API.
parametersRefable<OpenAPI3Parameter>[]Operation parameters; matching name/location pairs override path-level parameters.
requestBody?Refable<OpenAPI3RequestBody>Payload accepted by this operation, separate from path, query, header and cookie parameters.
responses?Refable<OpenAPI3Responses>Possible responses, including status-specific entries and an optional default.
security?Record<string, string[]>[]Overrides document-level security. Entries are alternatives; schemes within an entry are all required. An empty array removes inherited requirements.
summary?stringShort explanation suitable for operation lists.
tags?string[]Tag names used to group this operation; document-level tag metadata is optional.