{"record":{"id":"9cd25109b94c4c6b","repo":"hasura/graphql-engine","slug":"config-v-is-not-supported-9cd251","errorCode":null,"errorMessage":"config %v is not supported","messagePattern":"config (.+?) is not supported","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli/pkg/metadata/project_metadata.go","lineNumber":140,"sourceCode":"\tec.Stderr = io.Discard\n\n\terr := ec.Prepare()\n\tif err != nil {\n\t\treturn nil, errors.E(op, err)\n\t}\n\n\tp := &ProjectMetadata{ec}\n\tfor _, opt := range opts {\n\t\topt(p)\n\t}\n\n\terr = ec.Validate()\n\tif err != nil {\n\t\treturn nil, errors.E(op, err)\n\t}\n\n\tif ec.Config.Version <= cli.V1 {\n\t\treturn nil, errors.E(op, fmt.Errorf(\"config %v is not supported\", ec.Config.Version))\n\t}\n\n\treturn p, nil\n}\n","sourceCodeStart":122,"sourceCodeEnd":145,"githubUrl":"https://github.com/hasura/graphql-engine/blob/724551b9ae87845594ef0408cff0e50eb6c90dc5/cli/pkg/metadata/project_metadata.go#L122-L145","documentation":"NewProjectMetadata refuses to construct a ProjectMetadata when the project's config version is <= cli.V1 (i.e. config version 1). Hasura CLI v2+ metadata operations only support config version 2 and 3; version-1 projects must be migrated. The message interpolates the actual version value found in config.yaml.","triggerScenarios":"Calling NewProjectMetadata in a project whose config.yaml has `version: 1` (or a value parsing as <= V1, e.g. 0 or missing). The check runs after ec.Validate(), so the config itself is otherwise valid.","commonSituations":"Opening a legacy Hasura v1 project with a modern CLI; config.yaml left at version 1 after a partial upgrade; CI checking out an old branch with a v1 config; version field typo like `version: 1.0`.","solutions":["Update config.yaml to `version: 3` (preferred) or `version: 2` and adjust config keys to the new format","Or use the legacy Hasura CLI v1 binary for that project","Run `hasura init` in a fresh directory with the new CLI and port over migrations/metadata to get a valid v3 config","Ensure the correct project directory is being used (the one with the upgraded config.yaml)"],"exampleFix":"# before (config.yaml)\nversion: 1\n# after\nversion: 3","handlingStrategy":"validation","validationCode":"cfg, _ := util.ParseConfig(\"config.yaml\")\nif cfg.Version <= 1 {\n    return fmt.Errorf(\"upgrade config.yaml to version 2 or 3 before using metadata commands\")\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Upgrade project config.yaml as part of CLI upgrades","Check config version in CI before running any hasura commands","Document the supported config versions for your team"],"tags":["config","version","hasura-cli","project-setup"],"backgroundTag":"unsupported-config-version","analyzedSha":"724551b9ae87845594ef0408cff0e50eb6c90dc5","analyzedAt":"2026-08-28T07:32:55.105Z","schemaVersion":2},"datasetVersion":"2026-08-28T11:17:15.048Z"}