{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Common API Error Catalog","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"common-api-error-catalog","__idx":0},"children":["Common API Error Catalog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This topic identifies the most common error codes and messages returned by Celonis APIs. Specifically, the errors listed below are in the global, or default, domain for Celonis APIs. Some APIs also define their own domains, which identify API-specific errors that are not in the global domain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-and-authorization-errors","__idx":1},"children":["Authentication and Authorization Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","rowSpan":2,"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Returned when "," "]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request does not provide a Bearer token."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\"error\": \"Unauthorized\"}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Bearer token is passed but is empty or follows an invalid format."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\nInvalid \"Authorization\" header format.\nShould start either with \"Bearer\" or \"AppKey\" (case insensitive).\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user does not have permission to access a specific resource such as a Knowledge Model."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n \"title\": \"Access Denied.\",\n \"status\": 403,\n \"detail\": \"Access is denied\",\n \"errorCode\": \"ADMIN_ACCESS_ERROR\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The API is disabled."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"EMPTY BODY\n","lang":"javascript"},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-errors","__idx":2},"children":["Common Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","rowSpan":2,"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Returned when "," "]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sending an invalid format as part of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," parameter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Query parameter type mismatch.\",\n  \"status\": 400,\n  \"detail\": \"Invalid query parameter type.\",\n  \"errorCode\": \"GENERAL_PARAMETER_MISSMATCH\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sending an invalid format as part of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageSize"]}," parameter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Query parameter type mismatch.\",\n  \"status\": 400,\n  \"detail\": \"Invalid query parameter type.\",\n  \"errorCode\": \"GENERAL_PARAMETER_MISSMATCH\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sending an invalid format as part of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageSize"]}," parameter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Query parameter type mismatch.\",\n  \"status\": 400,\n  \"detail\": \"Invalid query parameter type.\",\n  \"errorCode\": \"GENERAL_PARAMETER_MISSMATCH\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requesting a non-existing path."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Path not found.\",\n  \"status\": 404,\n  \"detail\": \"The path does not exist.\",\n  \"errorCode\": \"GENERAL_NOTFOUND_PATH\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unexpected server-side error."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Unexpected error.\",\n  \"status\": 500,\n  \"detail\": \"Something went wrong while handling the request. Please contact Celonis customer support. Celonis Support ID: 671d3bdc-9feb-45ff-b367-7b47470d4680\",\n  \"errorCode\": \"ADMIN_FATAL_ERROR\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit has been exceeded."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Rate limit exceeded\",\n  \"status\": 429,\n  \"detail\": \"Rate limit for INTELLIGENCE_API_RATE_LIMIT is exceeded. Please try again at 06:10:41 UTC.\",\n  \"errorCode\": \"LIMIT_RATE_EXCEEDED\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit is not found for the size defition."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Limit MAX_REQUESTS not found.\",\n  \"status\": 404,\n  \"detail\": \"Limit MAX_REQUESTS in size L not found.\",\n  \"errorCode\": \"LIMIT_SIZE_NOTFOUND\"\n}\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit is not properly configured."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"title\": \"Limit MAX_REQUESTS not found.\",\n  \"status\": 404,\n  \"detail\": \"Invalid limit configuration.\",\n  \"errorCode\": \"LIMIT_NOTFOUND\"\n}\n\n","lang":"javascript"},"children":[]}]}]}]}]}]}]},"headings":[{"value":"Common API Error Catalog","id":"common-api-error-catalog","depth":1},{"value":"Authentication and Authorization Errors","id":"authentication-and-authorization-errors","depth":2},{"value":"Common Errors","id":"common-errors","depth":2}],"frontmatter":{"seo":{"title":"Common API Error Catalog"}},"lastModified":"2026-04-23T20:54:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/celonis-apis/api-reference/common-error-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}