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
- Read
supportedVersionsfromGET /tenant/v1/settingsand send one of them. - Leave the header out to use the account's default version.
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.