{"record":{"id":"1b62857bfb7ebd6c","repo":"elastic/elasticsearch","slug":"unknown-key-for-a-token-in-pipelineaggregatorn","errorCode":null,"errorMessage":"Unknown key for a {token} in [{pipelineAggregatorName}]: [{currentFieldName}].","messagePattern":"Unknown key for a (.+?) in \\[(.+?)\\]: \\[(.+?)\\]\\.","errorType":"validation","errorClass":"ParsingException","httpStatus":null,"severity":"error","filePath":"modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java","lineNumber":189,"sourceCode":"        String[] bucketsPaths = null;\n        String format = null;\n        String units = null;\n        GapPolicy gapPolicy = null;\n\n        while ((token = parser.nextToken()) != XContentParser.Token.END_OBJECT) {\n            if (token == XContentParser.Token.FIELD_NAME) {\n                currentFieldName = parser.currentName();\n            } else if (token == XContentParser.Token.VALUE_STRING) {\n                if (FORMAT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {\n                    format = parser.text();\n                } else if (BUCKETS_PATH_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {\n                    bucketsPaths = new String[] { parser.text() };\n                } else if (GAP_POLICY_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {\n                    gapPolicy = GapPolicy.parse(parser.text(), parser.getTokenLocation());\n                } else if (UNIT_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {\n                    units = parser.text();\n                } else {\n                    throw new ParsingException(\n                        parser.getTokenLocation(),\n                        \"Unknown key for a \" + token + \" in [\" + pipelineAggregatorName + \"]: [\" + currentFieldName + \"].\"\n                    );\n                }\n            } else if (token == XContentParser.Token.START_ARRAY) {\n                if (BUCKETS_PATH_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {\n                    List<String> paths = new ArrayList<>();\n                    while ((token = parser.nextToken()) != XContentParser.Token.END_ARRAY) {\n                        String path = parser.text();\n                        paths.add(path);\n                    }\n                    bucketsPaths = paths.toArray(new String[paths.size()]);\n                } else {\n                    throw new ParsingException(\n                        parser.getTokenLocation(),\n                        \"Unknown key for a \" + token + \" in [\" + pipelineAggregatorName + \"]: [\" + currentFieldName + \"].\"\n                    );\n                }","sourceCodeStart":171,"sourceCodeEnd":207,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java#L171-L207","documentation":"Error \"Unknown key for a {token} in [{pipelineAggregatorName}]: [{currentFieldName}].\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/aggregations/src/main/java/org/elasticsearch/aggregations/pipeline/DerivativePipelineAggregationBuilder.java:189 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"db6a809a667c081ca1dc7500389d26975573215f","analyzedAt":"2026-08-12T01:39:14.192Z","schemaVersion":2},"datasetVersion":"2026-08-12T08:17:17.861Z"}