Skip to documentation content
HintadataDocs

Unsupported Api Version

The requested contract version is not supported by the endpoint.

In this guide
  1. 1The requested contract version is not supported by the endpoint.
In this guide
  1. 1The requested contract version is not supported by the endpoint.

Unsupported Api Version

unsupported_api_versionversioning
Retry: Not before correction

What happened

The requested contract version is not supported by the endpoint.

Possible causes

  • The client requested a removed or unknown API version.conditional
  • Client and server version configuration disagree.conditional

Check in this order

  1. Verify the response evidenceread-only

    Compare the requested version with X-Supported-API-Versions and the current migration guide.

    error.code · HTTP status · request_id · X-Trace-Id

Safe recovery

Correct the cause before retryingmutation

Move the request to a supported version and apply the documented migration before retrying.

Retry: Not before correction

Success evidence

  • A new response satisfies the documented success contract.

Stop condition

Do not retry until the diagnostic check identifies a corrected input or configuration.

Verification evidence

Contractverifiedcontract-derivedSynthetic recoverynot-applicablecontract-derivedRead-only staging canarynot-applicablecontract-derivedProduction observationno-evidencecontract-derived
Was this page helpful?