List of Speakeasy extensions

Extension	Description	Docs
`x-speakeasy-name-override`	Use it globally to change method names or inline to change the name of a method, parameter, or class.	Full docs
`x-speakeasy-group`	Allows you to define custom namespaces when adding this property to any operation in your OpenAPI spec. If added, the tags for that method will be ignored and the value of `x-speakeasy-group` will define the namespace for that method instead.	Full docs
`x-speakeasy-ignore`	Exclude certain methods from your SDK with this extension.	Full docs
`x-speakeasy-enums`	Use this extension to control generated enum members by providing alternative names for each value in the enum field.	Full docs
`x-speakeasy-enum-format`	Customize how the enum type is generated for the schema, either `enum` for a native enum type or `union` for a union of values.	Full docs
`x-speakeasy-retries`	Enable retries globally or on a per-request basis. A backoff strategy is applied to specified status codes.	Full docs
`x-speakeasy-pagination`	Use to customize offset- or cursor-based pagination rules for each API operation.	Full docs
`x-speakeasy-usage-example`	Feature a method in your SDK’s `README.md` by adding this property to the method.	Full docs
`x-speakeasy-example`	The OpenAPI specification doesn’t allow example values for `securityscheme` property. Using this extension overcomes this limitation.	Full docs
`x-speakeasy-docs`	Configure comments that only show up in the SDK for a single language.	Full docs
`x-speakeasy-globals`	Define parameters that can be configured globally on the main SDK instance and populated automatically for any operations that use them.	Full docs
`x-speakeasy-globals-hidden`	Define parameters that can be configured globally on the main SDK instance but are not shown in the matching method’s signature.	Full docs
`x-speakeasy-errors`	Apply this extension at the level of `paths`, `path` `item`, or `operation` in the document to override the default error-handling behavior of the SDKs.	Full docs
`x-speakeasy-error-message`	Used to mark a field in an error response as containing the error message to use.	Full docs
`x-speakeasy-server-id`	Enable users to pick a server when instantiating the SDK. Use this extension to define an ID for each server in the `servers` array in the OpenAPI spec.	Full docs
`x-speakeasy-deprecation-message`	Allows you to add a message to deprecated operations, parameters, and schemas.	Full docs
`x-speakeasy-deprecation-replacement`	Allows you to specify an alternate operation to use in place of a deprecated operation.	Full docs
`x-speakeasy-type-override`	Use this to override a schema’s type, forcing it to be handled as `any` to accept arbitrary data.	Full docs
`x-speakeasy-max-method-params`	Allows you to set the maximum number of parameters that can be passed to a method. If the number of parameters exceeds this value, a request object will be used instead.	Full docs
`x-speakeasy-param-encoding-override`	When set with a value of `allowReserved`, path parameters will appear in a request URL with reserved characters `:/?#[]@!$&'()*+,;=` unencoded. Currently in Java only.	Full docs

You can use x-speakeasy-extension-rewrite to map any extension from the wider OpenAPI ecosystem or another vendor to the equivalent Speakeasy extension. This allows you to use your existing OpenAPI spec without needing to make changes to it, if necessary.

openapi: 3.1.0
info:
  title: My API
  version: 1.0.0
x-speakeasy-extension-rewrite:
  x-speakeasy-enums: x-enum-varnames # Maps x-enum-varnames used by the OSS generator to x-speakeasy-enums which has the same functionality

Terraform-specific extensions

Terraform extension	Description	Docs
`x-speakeasy-entity`	Map API entities to Terraform resources by annotating objects in your OpenAPI spec as entities in the Terraform provider.	Full docs
`x-speakeasy-entity-operation`	Specify CRUD operations for API endpoints to map to Terraform resources, such as create, read, update, or delete operations.	Full docs
`x-speakeasy-name-override`	Remap API properties to Terraform attribute names while keeping API data handling intact.	Full docs
`x-speakeasy-param-sensitive`	Hide sensitive properties from Terraform console output for security purposes.	Full docs
`x-speakeasy-terraform-ignore`	Use this extension to exclude properties from Terraform state management.	Full docs
`x-speakeasy-type-override`	Allows the conversion of an attribute to a JSON string, accommodating dynamic structures in Terraform configurations.	Full docs
`x-speakeasy-plan-validators`	Add custom validation logic to Terraform plan operations to ensure configurations meet predefined criteria before execution.	Full docs
`x-speakeasy-plan-modifiers`	Add custom plan modification logic to Terraform plan operations for advanced default values or resource replacement logic.	Full docs
`x-speakeasy-entity-version`	Specify the version of a Terraform resource to support state migrations for breaking changes.	Full docs
`x-speakeasy-conflicts-with`	Indicate conflicting properties to prevent incompatible combinations in Terraform configurations.	Full docs
`x-speakeasy-param-readonly`	Mark properties as read-only in Terraform, preventing modifications by the user.	Full docs
`x-speakeasy-param-optional`	Force a property to be optional, overriding the required attribute in JSON Schema specifications.	Full docs
`x-speakeasy-param-force-new`	Force resource recreation in Terraform when certain property values change.	Full docs
`x-speakeasy-terraform-plan-only`	Ensure that only values from the Terraform plan are used during updates, overriding prior state or default values.	Full docs