{"record":{"id":"3b6682ec70686f75","repo":"hasura/graphql-engine","slug":"the-version-specified-in-the-capabilities-versi-3b6682","errorCode":null,"errorMessage":"The version specified in the capabilities (\"{version}\") is not compatible with the schema version specified. The version requirement is {requirement}","messagePattern":"The version specified in the capabilities \\(\"(.+?)\"\\) is not compatible with the schema version specified\\. The version requirement is (.+?)","errorType":"validation","errorClass":"DataConnectorError::IncompatibleNdcVersion","httpStatus":null,"severity":"error","filePath":"v3/crates/metadata-resolve/src/stages/data_connectors/error.rs","lineNumber":39,"sourceCode":"pub enum DataConnectorError {\n    #[error(\"the data connector is defined more than once\")]\n    DuplicateDataConnectorDefinition,\n    #[error(\"The url for the data connector is invalid: {error}\")]\n    InvalidDataConnectorUrl { error: url::ParseError },\n    #[error(\"Invalid header name {header_name} specified\")]\n    InvalidHeaderName { header_name: String },\n    #[error(\"Invalid value specified for header {header_name}\")]\n    InvalidHeaderValue { header_name: String },\n    #[error(\"{0}\")]\n    NdcValidationError(NDCValidationError),\n    #[error(\n        \"The version specified in the capabilities (\\\"{version}\\\") is an invalid version: {error}\"\n    )]\n    InvalidNdcVersion {\n        version: String,\n        error: semver::Error,\n    },\n    #[error(\n        \"The version specified in the capabilities (\\\"{version}\\\") is not compatible with the schema version specified. The version requirement is {requirement}\"\n    )]\n    IncompatibleNdcVersion {\n        version: String,\n        requirement: semver::VersionReq,\n    },\n}\n\n#[derive(Debug, thiserror::Error)]\n#[error(\"The data connector {data_connector_name} has an issue: {issue}\")]\npub struct NamedDataConnectorIssue {\n    pub data_connector_name: Qualified<DataConnectorName>,\n    pub issue: DataConnectorIssue,\n}\n\nimpl ShouldBeAnError for NamedDataConnectorIssue {\n    fn should_be_an_error(&self, flags: &flags::OpenDdFlags) -> bool {\n        self.issue.should_be_an_error(flags)","sourceCodeStart":21,"sourceCodeEnd":57,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/data_connectors/error.rs#L21-L57","documentation":"The capabilities' SemVer version is parseable but does not satisfy the version requirement this build expects for the NDC schema, making the connector incompatible.","triggerScenarios":"Connector reports a version outside the supported range, e.g. an old 0.x connector with a build requiring ^1.x.","commonSituations":"Upgrading the platform without upgrading connectors, or vice versa; version skew between CLI/engine and connector.","solutions":["Check the reported version vs the stated requirement","Upgrade (or pin) the data connector to a compatible version","Alternatively use a platform version matching the connector"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"let req: semver::VersionReq = REQUIRED.parse()?;\nassert!(req.matches(&semver::Version::parse(&capabilities.version)?));","typeGuard":null,"tryCatchPattern":"Catch IncompatibleNdcVersion and suggest connector upgrade/downgrade paths based on the requirement string.","preventionTips":["Track the platform's supported connector version range in release notes","Upgrade connectors in lockstep with platform upgrades"],"tags":["ndc","semver","version-compatibility"],"backgroundTag":"version-mismatch","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}