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

AI Agent API Error Catalog

\n

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

\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 whenResponse
Status codeExample
Referencing a non-existing Celonis Process Copilot.400\n 
\n                {\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
Referencing a non-existing tool.404\n 
\n                {\n                   \"title\": \"Tool not found.\",\n                   \"status\": 404,\n                   \"detail\": \"The tool Id: 'XXXX' wasn't found\",\n                   \"errorCode\": \"AGENT_TOOL_NOTFOUND\"\n                }\n
\n
Either the specified agent is unavailable or your account doesn't have permission to use it.400\n 
\n                {\n                   \"title\": \"Access denied.\",\n                   \"status\": 400,\n                   \"detail\": \"Agent access denied.\",\n                }\n
\n
Referencing an agent you don't have access to403\n 
\n                {\n                   \"title\": \"Access denied.\",\n                   \"status\": 403,\n                   \"detail\": \"Agent access denied.\",\n                }\n
\n
","headings":[{"value":"AI Agent API Error Catalog","depth":1}]},"contentItem":{"data":{"lastModified":"2025-04-07T13:57:00.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"5145a653-372d-5236-8192-736f7ee2931a__redocly content/process-intelligence-apis/agents-api/api-reference/error-catalog/","seo":{"title":"AI Agent API Error Catalog","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/agents-api/api-reference/error-catalog.md","pageBaseUrl":"/process-intelligence-apis/agents-api/api-reference/error-catalog","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"AI Agent API Error Catalog","id":"ai-agent-api-error-catalog"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/agents-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"]}