{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/process-intelligence-apis/knowledge-model-api/api-reference/error-catalog/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Knowledge Model API Error Catalog

\n

This section documents the errors that the Knowledge Model API may return (standard error messages are described in Common API Error Catalog).

\n

Schema Endpoints Errors

\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n
Returned when\n Response\n
Status code\n Example\n
Requesting a non-existing field in the sort parameter.\n 400\n \n
\n{\n   \"title\": \"Some fields in sort don't exist in fields.\",\n   \"status\": 400,\n   \"detail\": \"The sort field does not exist.\",\n   \"errorCode\": \"SORT_UNKNOWN_FIELD\"\n}\n
\n
Sending, as part of the sort parameter, the same field with opposite sorting criterias.\n 400\n \n
\n{\n   \"title\": \"Some sort fields have duplicated fields.\",\n   \"status\": 400,\n   \"detail\": \"Conflicting sort parameters: duplicate fields with opposite directions.\",\n   \"errorCode\": \"SORT_HAS_OPPOSITE\"\n}\n
\n
Sending an empty sort parameter.\n 400\n 
{\n   \"title\": \"Sort parameter error length.\",\n   \"status\": 400,\n   \"detail\": \"Sort parameter should not be empty.\",\n   \"errorCode\": \"SORT_IS_EMPTY\"\n}
\n
Referencing a non-existing Knowledge Model.\n 404\n \n
{\n   \"title\": \"Knowledge Model not found.\",\n   \"status\": 404,\n   \"detail\": \"Knowledge Model with id 'XXXX' was not found.\",\n   \"errorCode\": \"KM_MODEL_NOTFOUND\"\n}
\n
Referencing a non-existing record.\n 404\n \n
{\n   \"title\": \"Records not found.\",\n   \"status\": 404,\n   \"detail\": \"Record Id(s) does not exist in Knowledge Model.\",\n   \"errorCode\": \"KM_RECORD_NOTFOUND\"\n}\n
\n
\n

Data Endpoint Errors

\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Returned when\n Response\n
Status code\n Example\n
Not sending the fields and kpis parameters.\n 400\n 
{\n   \"title\": \"Missing parameters.\",\n   \"status\": 400,\n   \"detail\": \"Required request parameter 'fields' for method parameter type List is not present\",\n   \"errorCode\": \"GENERAL_PARAMETER_MISSING\"\n}
\n
Passing an empty fields parameter.\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[fields: size must be between 1 and 200]\",\n   \"errorCode\": \"GENERAL_CONSTRAINT_VIOLATION\"\n}
\n
Requesting a non-existing field as part of the fields parameter.\n 400\n 
{\n   \"title\": \"Field not found.\",\n   \"status\": 400,\n   \"detail\": \"Fields not found: test. Note: Fields are case sensitive.\",\n   \"errorCode\": \"KM_FIELD_NOTFOUND\"\n}
\n
Requesting a non-existing field in the sort parameter.\n 400\n 
{\n   \"title\": \"Unknown sorting fields\",\n   \"status\": 400,\n   \"detail\": \"These fields don't exist at the given record [test].\",\n   \"errorCode\": \"SORT_UNKNOWN_FIELD\"\n}
\n
Referencing a non-existing filter as part of the filters parameter.\n 404\n 
{\n   \"title\": \"Filter not found.\",\n   \"status\": 404,\n   \"detail\": \"Filter not Found: name.\",\n   \"errorCode\": \"FILTERS_FILTER_NOTFOUND\"\n}
\n
Using a non-filterable field in the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Field not filterable.\",\n   \"status\": 400,\n   \"detail\": \"Field not filterable: mykpi\",\n   \"errorCode\": \"FILTERS_FIELD_UNFILTERABLE\"\n}
\n
Using an invalid expression as part of the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Invalid expression structure.\",\n   \"status\": 400,\n   \"detail\": \"Invalid expression structure: mykpi eq\",\n   \"errorCode\": \"FILTERS_EXPRESSION_ILLEGAL\"\n}
\n
Using an invalid operator for the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Invalid expression Operator.\",\n   \"status\": 400,\n   \"detail\": \"Invalid expression Operator: sq\",\n   \"errorCode\": \"FILTERS_OPERATOR_ILLEGAL\"\n}
\n
Using an invalid syntax for the filterExpr parameter.\n 400\n 
{\n   \"title\": Failure getting results.\",\n   \"status\": 400,\n   \"detail\": \"Syntax error found in filterExpr. Please refer to the API documentation.\",\n   \"errorCode\": \"GENERAL_RESULTS_FAILURE\"\n}
\n
Sending a page bigger than 19.(When using pageSize = 50)\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[page: value must be between 0 and 19]\",\n   \"errorCode\": \"PAGE_VALUE_ILLEGAL\"\n}
\n
Sending a pageSize bigger than 50.\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[pageSize: size must be between 1 and 50]\",\n   \"errorCode\": \"PAGE_SIZE_ILLEGAL\"\n}
\n
Sending special characters in the sort parameter.\n 400\n 
{\n   \"title\": \"Special characters are not allowed.\",\n   \"status\": 400,\n   \"detail\": \"Some special characters were found and they are not allowed for querying.\",\n   \"errorCode\": \"GENERAL_CHARS_NOTALLOWED\"\n}
\n
Specifying a date in filterExpr in the wrong format.\n 400\n 
\n   \"title\": \"Invalid Value format.\",\n   \"status\": 400,\n   \"detail\": \"Invalid Value format: \",\n   \"errorCode\": \"GENERAL_WRONG_VALUE\"\n}
\n
Using an invalid option in options parameter.\n 400\n 
\n   \"title\": \"Query option not supported.\",\n   \"status\": 400,\n   \"detail\": \"[options: illegal option 'invalid']\",\n   \"errorCode\": \"OPTION_ILLEGAL\",\n}
\n
There’s an unexpected error as part of this request.\n 400\n 
{\n   \"title\": No data found.\",\n   \"status\": 400,\n   \"detail\": \"Error details\",\n   \"errorCode\": \"GENERAL_EMPTY_DATA\"\n}
\n
There’s an unexpected error as part of this request.\n 400\n 
{\n   \"title\": \"Knowledge Model Field Id repeated.\",\n   \"status\": 400,\n   \"detail\": \"Knowledge Model with repeated Field Ids: [FIELD_ID]. Please fix the Knowledge Model configuration.\",\n   \"errorCode\": \"KM_FIELD_ID_DUPLICATED\"\n   \"type\": \"https://developer.celonis.com/knowledge-model-api/error-catalog/\"\n}
\n
Using malformed error when searchField or searchTerm are empty.\n 400\n 
{\n   \"title\": \"Malformed expression\",\n   \"status\": 400,\n   \"detail\": \"Term and field search parameters should be filled\",\n   \"errorCode\": \"SEARCH_MATCH_EXPRESSION\"\n}
\n
Using error when searchField value is not exist.\n 400\n 
{\n   \"title\": \"Search match field not found\",\n   \"status\": 400,\n   \"detail\": \"Field not found: XXX\",\n   \"errorCode\": \"SEARCH_FIELD_NOT_FOUND\"\n}
\n
Using error when kpis value is not exist.\n 400\n 
{\n   \"title\": \"KPI not found.\",\n   \"status\": 400,\n   \"detail\": \"KPI not found: kpiId. Note: KPI are case sensitive.\",\n   \"errorCode\": \"KM_KPI_NOTFOUND\"\n}
\n
Using error when kpis value contains special characters.\n 400\n 
{\n   \"title\": \"KPI not allowed.\",\n   \"status\": 400,\n   \"detail\": \"KPI contains not allowed special chars\",\n   \"errorCode\": \"KM_KPI_ILLEGALCHARS\"\n}
\n
Using error when fields value does not contain recordId.\n 400\n 
{\n   \"title\": \"Field with wrong format.\",\n   \"status\": 400,\n   \"detail\": \"Field with wrong format, it should contain recordId.fieldId: fieldId\",\n   \"errorCode\": \"GENERAL_PARAMETER_ILLEGAL\"\n}
\n
\n

Query Endpoints Errors

\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n
Returned when\n Response\n
Status code\n Example\n
Not sending the fields parameter.\n 400\n 
{\n   \"title\": \"Missing parameters.\",\n   \"status\": 400,\n   \"detail\": \"Required request parameter 'fields' for method parameter type List is not present\",\n   \"errorCode\": \"GENERAL_PARAMETER_MISSING\"\n}
\n
Passing an empty fields parameter.\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[fields: size must be between 1 and 200]\",\n   \"errorCode\": \"GENERAL_CONSTRAINT_VIOLATION\"\n}
\n
Requesting a non-existing field as part of the fields parameter.\n 400\n 
{\n   \"title\": \"Field not found.\",\n   \"status\": 400,\n   \"detail\": \"Fields not found: test. Note: Fields are case sensitive.\",\n   \"errorCode\": \"KM_FIELD_NOTFOUND\"\n}
\n
Requesting a non-existing field in the sort parameter.\n 400\n 
{\n   \"title\": \"Unknown sorting fields\",\n   \"status\": 400,\n   \"detail\": \"These fields don't exist at the given record [test].\",\n   \"errorCode\": \"SORT_UNKNOWN_FIELD\"\n}
\n
Referencing a non-existing filter as part of the filters parameter.\n 404\n 
{\n   \"title\": \"Filter not found.\",\n   \"status\": 404,\n   \"detail\": \"Filter not Found: name.\",\n   \"errorCode\": \"FILTERS_FILTER_NOTFOUND\"\n}
\n
Using a non-filterable field in the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Field not filterable.\",\n   \"status\": 400,\n   \"detail\": \"Field not filterable: mykpi\",\n   \"errorCode\": \"FILTERS_FIELD_UNFILTERABLE\"\n}
\n
Using an invalid expression as part of the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Invalid expression structure.\",\n   \"status\": 400,\n   \"detail\": \"Invalid expression structure: mykpi eq\",\n   \"errorCode\": \"FILTERS_EXPRESSION_ILLEGAL\"\n}
\n
Using an invalid operator for the filterExpr parameter.\n 400\n 
{\n   \"title\": \"Invalid expression Operator.\",\n   \"status\": 400,\n   \"detail\": \"Invalid expression Operator: sq\",\n   \"errorCode\": \"FILTERS_OPERATOR_ILLEGAL\"\n}
\n
Using an invalid syntax for the filterExpr parameter.\n 400\n 
{\n   \"title\": Failure getting results.\",\n   \"status\": 400,\n   \"detail\": \"Syntax error found in filterExpr. Please refer to the API documentation.\",\n   \"errorCode\": \"GENERAL_RESULTS_FAILURE\"\n}
\n
Sending a page bigger than 19.(When using pageSize = 50)\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[page: value must be between 0 and 19]\",\n   \"errorCode\": \"PAGE_VALUE_ILLEGAL\"\n}
\n
Sending a pageSize bigger than 50.\n 400\n 
{\n   \"title\": \"Some params have constraint violations.\",\n   \"status\": 400,\n   \"detail\": \"[pageSize: size must be between 1 and 50]\",\n   \"errorCode\": \"PAGE_SIZE_ILLEGAL\"\n}
\n
Sending special characters in the sort parameter.\n 400\n 
{\n   \"title\": \"Special characters are not allowed.\",\n   \"status\": 400,\n   \"detail\": \"Some special characters were found and they are not allowed for querying.\",\n   \"errorCode\": \"GENERAL_CHARS_NOTALLOWED\"\n}
\n
Specifying a date in filterExpr in the wrong format.\n 400\n 
\n   \"title\": \"Invalid Value format.\",\n   \"status\": 400,\n   \"detail\": \"Invalid Value format: \",\n   \"errorCode\": \"GENERAL_WRONG_VALUE\"\n}
\n
Using an invalid option in options parameter.\n 400\n 
\n   \"title\": \"Query option not supported.\",\n   \"status\": 400,\n   \"detail\": \"[options: illegal option 'invalid']\",\n   \"errorCode\": \"OPTION_ILLEGAL\",\n}
\n
There’s an unexpected error as part of this request.\n 400\n 
{\n   \"title\": No data found.\",\n   \"status\": 400,\n   \"detail\": \"Error details\",\n   \"errorCode\": \"GENERAL_EMPTY_DATA\"\n}
\n
Using malformed error when searchField or searchTerm are empty.\n 400\n 
{\n   \"title\": \"Malformed expression\",\n   \"status\": 400,\n   \"detail\": \"Term and field search parameters should be filled\",\n   \"errorCode\": \"SEARCH_MATCH_EXPRESSION\"\n}
\n
Using error when searchField value is not exist.\n 400\n 
{\n   \"title\": \"Search match field not found\",\n   \"status\": 400,\n   \"detail\": \"Field not found: XXX\",\n   \"errorCode\": \"SEARCH_FIELD_NOT_FOUND\"\n}
\n
Sending special characters in the searchField parameter.\n 400\n 
{\n   \"title\": \"Search match fields not allowed.\",\n   \"status\": 400,\n   \"detail\": \"Search match fields contain prohibited special characters.\",\n   \"errorCode\": \"SEARCH_FIELDS_ILLEGALCHARS\"\n}
\n
Sending special characters in the searchTerm parameter.\n 400\n 
{\n   \"title\": \"Search match terms not allowed.\",\n   \"status\": 400,\n   \"detail\": \"Search match terms contain prohibited special characters.\",\n   \"errorCode\": \"SEARCH_TERMS_ILLEGALCHARS\"\n}
\n
","headings":[{"value":"Knowledge Model API Error Catalog","depth":1},{"value":"Schema Endpoints Errors","depth":2},{"value":"Data Endpoint Errors","depth":2},{"value":"Query Endpoints Errors","depth":2}]},"contentItem":{"data":{"lastModified":"2025-10-08T17:12:59.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"97aa210a-feb2-51d2-ad49-fb93c9b4650f__redocly content/process-intelligence-apis/knowledge-model-api/api-reference/error-catalog/","seo":{"title":"Knowledge Model API Error Catalog","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/knowledge-model-api/api-reference/error-catalog.md","pageBaseUrl":"/process-intelligence-apis/knowledge-model-api/api-reference/error-catalog","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Knowledge Model API Error Catalog","id":"knowledge-model-api-error-catalog"},{"depth":2,"value":"Schema Endpoints Errors","id":"schema-endpoints-errors"},{"depth":2,"value":"Data Endpoint Errors","id":"data-endpoint-errors"},{"depth":2,"value":"Query Endpoints Errors","id":"query-endpoints-errors"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/knowledge-model-api/api-reference/error-catalog/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}