{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"AI Agent 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":"ai-agent-api-error-catalog","__idx":0},"children":["AI Agent API Error Catalog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section documents the errors that AI Agent APIs may return (standard error messages are described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/celonis-apis/api-reference/common-error-catalog"},"children":["Common API Error Catalog"]},")."]},{"$$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":{"colSpan":2,"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}," "]}]}]},{"$$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":["Referencing a non-existing Celonis Process Copilot."]},{"$$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\": \"AI Agent not found.\",\n      \"status\": 400,\n      \"detail\": \"AI Agent with id 'XXXX' was not found.\",\n      \"errorCode\": \"AGENT_NOTFOUND\"\n   }\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Either the specified agent is unavailable or your account doesn't have permission to use it."]},{"$$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\": \"Access denied.\",\n      \"status\": 400,\n      \"detail\": \"Agent access denied.\",\n   }\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Referencing an agent you don't have access to"]},{"$$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\": \"Agent access denied.\",\n   }\n\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access to the Chat conversation endpoint is forbidden because the feature has not been enabled for the requested Asset. This usually means the External Integrations UI Toggle is currently disabled.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remediation:"]}," Follow the enablement steps in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/process-intelligence-apis/agents-api/get-started/getting-started#prerequisites"},"children":["Getting Started"]},"."]},{"$$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\": \"Chat API is not enabled for external use.\",\n      \"status\": 403,\n      \"detail\": \"Chat API is not enabled for this Process Copilot. Enable it in the Process Copilot's integrations configuration.\",\n   }\n\n","lang":"javascript"},"children":[]}]}]}]}]}]}]},"headings":[{"value":"AI Agent API Error Catalog","id":"ai-agent-api-error-catalog","depth":1}],"frontmatter":{"seo":{"title":"AI Agent API Error Catalog"}},"lastModified":"2026-03-06T16:57:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/process-intelligence-apis/agents-api/api-reference/error-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}