Timeouts

Speakeasy allows configuring request timeouts in an SDK using the x-speakeasy-timeout extension in the OpenAPI document. Timeouts can be enabled globally for all operations or on a per-operation basis. SDK end users can override the default configuration by passing in a timeout option at runtime.

Timeout values are always provided in milliseconds.

Global timeouts

Adding the x-speakeasy-timeout extension to the root of the OpenAPI document configures a global timeout for all requests made by the SDK.

Per-request timeouts

Adding the x-speakeasy-timeout extension to any operation overrides the global timeout configuration for that operation or sets a timeout if no global configuration exists.

Overriding timeout configuration

Users of the SDK can override the timeout configuration globally or at the request level.

Globally overriding timeout configuration

To override the timeout configuration globally, initialize the SDK object with the appropriate options parameter. In all cases, if no override is provided, the timeout configuration provided in the OpenAPI document will be used.

Overriding timeout configuration at the request level

Users can override the timeout config on a per-operation basis.