AI Agent API Error Catalog

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

Returned when Response
Status code Example
Referencing a non-existing Celonis Process Copilot. 400 
                {
                   "title": "AI Agent not found.",
                   "status": 400,
                   "detail": "AI Agent with id 'XXXX' was not found.",
                   "errorCode": "AGENT_NOTFOUND"
                }
Referencing a non-existing tool. 404 
                {
                   "title": "Tool not found.",
                   "status": 404,
                   "detail": "The tool Id: 'XXXX' wasn't found",
                   "errorCode": "AGENT_TOOL_NOTFOUND"
                }
Either the specified agent is unavailable or your account doesn't have permission to use it. 400 
                {
                   "title": "Access denied.",
                   "status": 400,
                   "detail": "Agent access denied.",
                }
Referencing an agent you don't have access to 403 
                {
                   "title": "Access denied.",
                   "status": 403,
                   "detail": "Agent access denied.",
                }