{"record":{"id":"bcfc29390bea7e5f","repo":"hasura/graphql-engine","slug":"ndc-validation-error-0-bcfc29","errorCode":null,"errorMessage":"NDC validation error: {0}","messagePattern":"NDC validation error: (.+?)","errorType":"validation","errorClass":"CommandsError::NDCValidationError","httpStatus":null,"severity":"error","filePath":"v3/crates/metadata-resolve/src/stages/commands/error.rs","lineNumber":152,"sourceCode":"        \"An error occurred while mapping arguments in the command {command_name:} to the procedure {procedure_name:} in the data connector {data_connector_name:}: {error:}\"\n    )]\n    CommandProcedureArgumentMappingError {\n        data_connector_name: Qualified<DataConnectorName>,\n        command_name: Qualified<CommandName>,\n        procedure_name: ProcedureName,\n        error: ArgumentMappingError,\n    },\n    #[error(\"{error:} in command {command_name:}\")]\n    CommandTypeMappingCollectionError {\n        command_name: Qualified<CommandName>,\n        error: TypeMappingCollectionError,\n    },\n\n    #[error(\"{0}\")]\n    DataConnectorError(#[from] data_connectors::NamedDataConnectorError),\n    #[error(\"{0}\")]\n    GraphqlConfigError(#[from] graphql_config::GraphqlConfigError),\n    #[error(\"NDC validation error: {0}\")]\n    NDCValidationError(#[from] NDCValidationError),\n}\n","sourceCodeStart":134,"sourceCodeEnd":155,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/metadata-resolve/src/stages/commands/error.rs#L134-L155","documentation":"Commands-stage error variant that wraps an NDCValidationError during command resolution. NDC validation checks the data connector's capabilities/schema document against the NDC spec; failures are surfaced with the 'NDC validation error:' prefix.","triggerScenarios":"A command backed by a data connector whose capabilities response or schema fails NDC spec validation while metadata-resolve builds command metadata.","commonSituations":"Data connector returns non-conformant capabilities JSON after an upgrade, or an old connector version emits a schema the spec validator rejects.","solutions":["Inspect the inner NDCValidationError details","Update the data connector to a version matching the expected NDC spec","Fix the capabilities/schema document the connector serves"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":"Catch and inspect the inner NDCValidationError to report which capability/schema checks failed.","preventionTips":["Pin connector versions that pass NDC validation in CI","Validate capabilities documents against the NDC spec before deployment"],"tags":["ndc","data-connector","validation","metadata"],"backgroundTag":"schema-validation-failed","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}