OpenAPI support matrix

The tables below provide an overview of the OpenAPI features supported by Speakeasy.

✅ Server configuration

Name

ServerURL config

Notes

Global and per-method (include base URL and templating)

Swagger link

API server and base path

Support

✅

Authentication and security

Notes

Global and per-method

Swagger link

Authentication

Support

✅

Method generation

Notes

Swagger link

Support

✅

Model generation

Notes

Request and response

Swagger link

Support

✅

Name	Notes	Swagger link	Support
ServerURL config	Global and per-method (include base URL and templating)	API server and base path	✅
Authentication and security	Global and per-method	Authentication	✅
Method generation			✅
Model generation	Request and response		✅

⚠️ Path parameters serialization (Path parameters )

Name

Default

Notes

Swagger link

Parameter serialization

Support

✅

Basic types

Notes

Swagger link

Support

✅

Simple objects

Notes

Swagger link

Support

✅

label

Notes

Swagger link

Support

❌

matrix

Notes

Swagger link

Support

❌

Name	Swagger link	Support
Default	Parameter serialization	✅
Basic types		✅
Simple objects		✅
label		❌
matrix		❌

⚠️ Query parameters serialization (Query parameters and query )

Name

json

Notes

Swagger link

Support

✅

form

Notes

Swagger link

Support

✅

spaceDelimited

Notes

Swagger link

Support

✅

pipeDelimited

Notes

Swagger link

Support

✅

deepObject

Notes

Swagger link

Support

✅

Basic types

Notes

Swagger link

Support

✅

Simple objects

Notes

Swagger link

Support

✅

Name	Notes	Swagger link	Support
json			✅
form			✅
spaceDelimited			✅
pipeDelimited			✅
deepObject			✅
Basic types			✅
Simple objects			✅

✅ Request headers (Header )

Name

Simple (explode = true)

Notes

Swagger link

Support

✅

Simple (explode = false)

Notes

Swagger link

Support

✅

Name	Notes	Swagger link	Support
Simple (explode = true)			✅
Simple (explode = false)			✅

⚠️ Request body serialization

Name

Multipart encoding

Notes

Swagger link

Multipart requests

Support

✅

Binary

Notes

Swagger link

Support

✅

Form data

Notes

Swagger link

Support

✅

JSON

Notes

Both

and

Swagger link

Support

✅

x-www-form-urlencoded

Notes

Including encoding, but not non-object types

Swagger link

Describing request body

Support

⚠️

Plain text

Notes

Swagger link

Support

✅

Raw byte

Notes

Swagger link

Support

✅

Handling

body

Notes

Swagger link

Support

✅

XML

Notes

Swagger link

Support

❌

Other media types

Notes

Swagger link

Support

❌

Name	Notes	Swagger link	Support
Multipart encoding		Multipart requests	✅
Binary			✅
Form data			✅
JSON	Both and		✅
x-www-form-urlencoded	Including encoding, but not non-object types	Describing request body	⚠️
Plain text			✅
Raw byte			✅
Handling body			✅
XML			❌
Other media types			❌

⚠️ Response body deserialization

Name

Return

and

Notes

Swagger link

Support

✅

JSON

Notes

Swagger link

Support

✅

Plain text

Notes

Swagger link

Support

✅

Raw byte

Notes

Swagger link

Support

✅

JSON

Notes

Swagger link

Support

✅

Other media types

Notes

Swagger link

Support

❌

Name	Notes	Swagger link	Support
Return and			✅
JSON			✅
Plain text			✅
Raw byte			✅
JSON			✅
Other media types			❌

✅ Media-type patterns (Media types )

✅ Data types

Name

Basic types

Notes

Swagger link

Data models: Data types

Support

✅

Enums

Notes

Swagger link

Support

✅

Number formats

Notes

float, double, int32, int64

Swagger link

Support

✅

Date-time

Notes

Swagger link

Support

✅

Binary

Notes

Swagger link

Support

✅

Arrays

Notes

Swagger link

Support

✅

Objects

Notes

Swagger link

Support

✅

Optional

Notes

Swagger link

Support

✅

Maps

Notes

Swagger link

Support

✅

Any type

Notes

Swagger link

Support

✅

, and

Notes

Swagger link

oneOf, anyOf, allOf, not

Support

⚠️ See

support below

Name	Notes	Swagger link	Support
Basic types		Data models: Data types	✅
Enums			✅
Number formats	float, double, int32, int64		✅
Date-time			✅
Binary			✅
Arrays			✅
Objects			✅
Optional			✅
Maps			✅
Any type			✅
, , and		oneOf, anyOf, allOf, not	⚠️ See support below

✅ Union types

Name

oneOf

Notes

For languages that don't yet have native union type support in Speakeasy,

will be treated as an

type.

Language support

✅ TypeScript, Python, Go, C#, Java, PHP

allOf

Notes

To avoid construction of illogical types, Speakeasy currently constructs an object using the superset of fields from the listed schemas. In cases where the base schemas have a field name collision, Speakeasy will default to using the field from the object deepest in the list.

Language support

✅ All languages

anyOf

Notes

is treated as

to avoid the bloat of combinatorial data type creation.

Language support

✅ TypeScript, Python, Go

Name	Notes	Language support
oneOf	For languages that don't yet have native union type support in Speakeasy, will be treated as an type.	✅ TypeScript, Python, Go, C#, Java, PHP
allOf	To avoid construction of illogical types, Speakeasy currently constructs an object using the superset of fields from the listed schemas. In cases where the base schemas have a field name collision, Speakeasy will default to using the field from the object deepest in the list.	✅ All languages
anyOf	is treated as to avoid the bloat of combinatorial data type creation.	✅ TypeScript, Python, Go

✅ Miscellaneous

Name

Auxiliary files*

Notes

Swagger link

Support

✅

generation

Notes

Swagger link

Support

✅

Snippet generation

Notes

Swagger link

Support

✅

README generation

Notes

Swagger link

Support

✅

Documentation generation

Notes

Swagger link

Support

✅

Name	Notes	Swagger link	Support
Auxiliary files*			✅
generation			✅
Snippet generation			✅
README generation			✅
Documentation generation			✅

* Files needed for creating a fully compilable package that can be published to the relevant package manager without further changes.

Last updated on July 14, 2025