Skip to content
Get Started
/
/
Common Error Messages
Last updated

Common API Error Catalog

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.

Authentication and Authorization Errors

Returned when Response
Status codeExample
Request does not provide a Bearer token.401
{"error": "Unauthorized"}
The Bearer token is passed but is empty or follows an invalid format.401
{
Invalid "Authorization" header format.
Should start either with "Bearer" or "AppKey" (case insensitive).
}
The user does not have permission to access a specific resource such as a Knowledge Model.403
{
 "title": "Access Denied.",
 "status": 403,
 "detail": "Access is denied",
 "errorCode": "ADMIN_ACCESS_ERROR"
}
The API is disabled.403
EMPTY BODY

Common Errors

Returned when Response
Status codeExample
Sending an invalid format as part of the page parameter.400
{
  "title": "Query parameter type mismatch.",
  "status": 400,
  "detail": "Invalid query parameter type.",
  "errorCode": "GENERAL_PARAMETER_MISSMATCH"
}
Sending an invalid format as part of the pageSize parameter.400
{
  "title": "Query parameter type mismatch.",
  "status": 400,
  "detail": "Invalid query parameter type.",
  "errorCode": "GENERAL_PARAMETER_MISSMATCH"
}
Sending an invalid format as part of the pageSize parameter.400
{
  "title": "Query parameter type mismatch.",
  "status": 400,
  "detail": "Invalid query parameter type.",
  "errorCode": "GENERAL_PARAMETER_MISSMATCH"
}
Requesting a non-existing path.404
{
  "title": "Path not found.",
  "status": 404,
  "detail": "The path does not exist.",
  "errorCode": "GENERAL_NOTFOUND_PATH"
}
Unexpected server-side error.500
{
  "title": "Unexpected error.",
  "status": 500,
  "detail": "Something went wrong while handling the request. Please contact Celonis customer support. Celonis Support ID: 671d3bdc-9feb-45ff-b367-7b47470d4680",
  "errorCode": "ADMIN_FATAL_ERROR"
}
Rate limit has been exceeded.429
{
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit for INTELLIGENCE_API_RATE_LIMIT is exceeded. Please try again at 06:10:41 UTC.",
  "errorCode": "LIMIT_RATE_EXCEEDED"
}
Rate limit is not found for the size defition.404
{
  "title": "Limit MAX_REQUESTS not found.",
  "status": 404,
  "detail": "Limit MAX_REQUESTS in size L not found.",
  "errorCode": "LIMIT_SIZE_NOTFOUND"
}
Rate limit is not properly configured.404
{
  "title": "Limit MAX_REQUESTS not found.",
  "status": 404,
  "detail": "Invalid limit configuration.",
  "errorCode": "LIMIT_NOTFOUND"
}

Quotas and Rate Limiting

Use Cases