From f5c1a1a7b8d09840762929f6425bdce3eacf989d Mon Sep 17 00:00:00 2001 From: Karen Etheridge Date: Thu, 29 Oct 2026 14:21:51 -0700 Subject: [PATCH] Add "description" field to media-type object This property was added to the schema for the media-type object in commit 747ccc8 (for v3.2.0) but was inadvertently not also added to the specification text. --- src/oas.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/oas.md b/src/oas.md index 4948790dba..2a44a57844 100644 --- a/src/oas.md +++ b/src/oas.md @@ -1327,6 +1327,7 @@ See [Working With Examples](#working-with-examples) for further guidance regardi | Field Name | Type | Description | | ---- | :----: | ---- | +| description | `string` | An optional description for the media type. [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation. | | schema | [Schema Object](#schema-object) | A schema describing the complete content of the request, response, parameter, or header. | | itemSchema | [Schema Object](#schema-object) | A schema describing each item within a [sequential media type](#sequential-media-types). | | example | Any | Example of the media type; see [Working With Examples](#working-with-examples). |