Config Version Error • AI Agent SDK

ConfigVersionError: Raised when a config carries a “config_version“ this build can't handle.

ConfigVersionError

Defined in the config module.

Raised when a config carries a `config_version` this build can’t handle.

Two cases, both operator-actionable rather than silently corrupting data: the stamp is a version newer than :data:GATEWAY_CONFIG_VERSION — an older binary must not downgrade / migrate a config written by a newer one (that would drop keys the newer schema added), so migration refuses; the stamp is present but not a non-boolean integer — a malformed stamp (`true, "1", 1.0) is a mistake, not "current", so it is rejected instead of being treated as version 1 via True == 1`.

Source

Related Documentation