Media Type Registry
This registry lists the non-JSON media types addressed by the OpenAPI Specification (OAS), and links to the appropriate OAS sections and external specifications. See Parsing and Serializing for a discussion of serialized, schema-ready, and application forms of data, and how to convert among the forms.
Specification Versions
This registry is for and linked from version 3.2 and later of the OAS. Earlier versions and other specifications such as Arazzo MAY support approaches added in this registry, as long as the necessary Objects and fields are available in those versions.
Contributing
Please open a discussion explaining your use cases for any media type(s) you would like to see added.
Media Types
Note: Media types with a structured suffix are handled the same way as the media type corresponding to the suffix (e.g. all +json
media types are handled as application/json
).
Group | Description | Media Types |
---|---|---|
Binary | Non-text-based media types | application/octet-stream audio/* image/* video/* any unrecognized binary media type |
Forms | Ordered name-value pairs | application/x-www-form-urlencoded multipart/form-data |
Link Sets | Sets of RFC8288 Web Links | application/linkset application/linkset+json |
Sequential JSON | Multiple concatenated JSON documents suitable for streaming | application/jsonl application/json-seq application/x-ndjson |
Sequential Multipart | Multipart subtypes with unnamed parts | multipart/* multipart/mixed multipart/alternative multipart/related multipart/byteranges |
Server-Sent Events | Event streams for SSE | text/event-stream |
Text | Text-based media types | text/* text/plain any unrecognized text-based (not just text/*) media type |
XML | Extensible markup language | application/xml |