version_unknown: The deployment does not know this API version

The Dynamo-Version header (or the defaultVersion sent to PUT /tenant/v1/settings) names a version this deployment does not serve. Nothing was changed.

Only the multi-tenant hosted front door answers this code. It checks the header on requests it passes to the account's core (the owner, plugin wire, merchant, payee and oracle routes). A single-tenant core never refuses an unknown Dynamo-Version: it answers such a request like one that names no version, with the answers of the versions before 1.8.0.

What to do

On the wire

HTTP 400, error type invalid_request_error, param is Dynamo-Version (or defaultVersion).

{
  "error": "version_unknown",
  "errorDetail": {
    "type": "invalid_request_error",
    "code": "version_unknown",
    "message": "unknown Dynamo-Version \"0.9.0\"",
    "param": "Dynamo-Version",
    "doc_url": "…/errors/version_unknown.md",
    "fix": "send a Dynamo-Version the deployment supports (see GET /tenant/v1/settings)"
  }
}

For PUT /tenant/v1/settings the message is unknown version "…" and param is defaultVersion.

See all error codes.