{"record":{"id":"3571265bfcab6611","repo":"hasura/graphql-engine","slug":"argument-mapping-not-found-for-the-argument-argum","errorCode":null,"errorMessage":"Argument mapping not found for the argument {argument_name:} while executing the relationship {relationship_name:}","messagePattern":"Argument mapping not found for the argument (.+?) while executing the relationship (.+?)","errorType":"exception","errorClass":"InternalDeveloperError","httpStatus":null,"severity":"error","filePath":"v3/crates/graphql/ir/src/error.rs","lineNumber":214,"sourceCode":"        type_name: Qualified<CustomTypeName>,\n        field_name: FieldName,\n    },\n\n    #[error(\"Object type '{type_name}' not found\")]\n    ObjectTypeNotFound {\n        type_name: Qualified<CustomTypeName>,\n    },\n\n    #[error(\"The field '{field_name}' was not found on object type '{object_type_name}'\")]\n    ObjectTypeFieldNotFound {\n        field_name: FieldName,\n        object_type_name: Qualified<CustomTypeName>,\n    },\n\n    #[error(\"{0}\")]\n    RelationshipFieldMappingError(#[from] plan::RelationshipFieldMappingError),\n\n    #[error(\n        \"Argument mapping not found for the argument {argument_name:} while executing the relationship {relationship_name:}\"\n    )]\n    ArgumentMappingNotFoundForRelationship {\n        relationship_name: RelationshipName,\n        argument_name: ArgumentName,\n    },\n\n    #[error(\n        \"The aggregation function {aggregation_function} operating over the {aggregate_operand_type} type is missing a data connector mapping for {data_connector_name}\"\n    )]\n    DataConnectorAggregationFunctionNotFound {\n        aggregate_operand_type: QualifiedTypeName,\n        aggregation_function: AggregationFunctionName,\n        data_connector_name: Qualified<DataConnectorName>,\n    },\n\n    #[error(\n        \"A field ({field_name}) with an AggregatableField annotation was found on a scalar-typed ({aggregate_operand_type}) operand's selection set\"","sourceCodeStart":196,"sourceCodeEnd":232,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/v3/crates/graphql/ir/src/error.rs#L196-L232","documentation":"Thrown when executing a relationship whose argument mapping requires argument_name, but no mapping entry for that argument could be resolved. Relationship argument mappings bind GraphQL arguments to source fields or literals; a missing binding cannot be defaulted safely.","triggerScenarios":"A relationship defined with argument mappings where one declared argument has no mapping entry; passing an argument to a relationship that the metadata does not map; metadata hand-edited and missing the argument_mapping for one argument.","commonSituations":"Hand-writing or transforming metadata files and dropping an argument mapping; upgrading metadata format versions where argument mappings must be explicit.","solutions":["Add the missing argument mapping for argument_name in the relationship metadata","Regenerate the relationship metadata with the CLI instead of hand-editing","Ensure every argument the relationship declares has a corresponding mapping"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"# CLI/metadata check: assert every argument in the relationship has an argument mapping\nhasura validate metadata","typeGuard":null,"tryCatchPattern":"// Catch during planning; report which relationship/argument is unmapped to guide metadata fix","preventionTips":["Never hand-edit relationship argument mappings; regenerate them","Validate metadata before applying"],"tags":["graphql","relationship","argument-mapping","metadata"],"backgroundTag":"missing-argument-mapping","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}