Table of contents
Official Content
  • This documentation is valid for:

All API errors are returned in a consistent JSON structure.

You always receive errors in an errors array, where each item contains:

  • id: The numeric error code.
  • description: A human-readable explanation of the error.

For example:

{
  "errors": 
    {
      "id": 1,
      "description": "Assistant Not Found"
    }
  
}

Certain error descriptions can contain up to %n references specific to that error. These references are described with %1, %2, ... , %n.

ErrorCode Description
1 Assistant Not Found
2 Provider Type Not Found
3 Request Not Found
5 Api Key Not Found
6 ApiToken not found or blocked
7 ApiToken out of scope
8 Field %1 is out of range
9 Field %1 is required
10 Query Text Empty
11 Field %1 does not match the specified pattern
20 Bad Input Text
21 Session finished, login again.
30 Plugin not found
31 The plugin is disabled
32 Plugin not found as favorite
33 Conversation not found
34 Message not found
35 The conversation still contains messages.
36 User setting not found
37 The conversation type does not allow changes
44 The selected project does not have any associated files.
45 Unable to read or extract content. Please verify the file and try again.
46 The file format provided is not supported by this model.
47 The file size exceeds the limit allowed by this model.
48 Not Found File With This Name, please verify the fileName in the pattern
100 Provider Request Timeout
101 Refresh token error.
102 Token revoked, login again.
103 Token expired, login again
112 Access token not found, login again.
114 Access token not valid, login again.
122 Session token error, login again.
150 Provider Unknown Error
151 Provider Rate Limit
152 Provider Quota Exceeded
153 Provider Overcapacity
154 Quota exceeded.
401 Unauthorized
403 Forbidden
404 Bad Endpoint
409 Conflict
413 Payload Too Large
422 The request was blocked by guardrails due to a policy violation.
500 Internal Server Error
502 Bad Gateway
1001 Provider Configuration Error
1010 Search Profile Not Found
1101 Search Index Profile Name not found
1102 Request Failed
1103 RAG Assistant %1 Not Found
2000 Invalid ProjectName
2001 Invalid OrganizationId
2002 ProjectName %1 already exists in the Organization
2003 Organization name already exists
2004 Organization Not Found
2005 Project Not Found
2006 Project not in Organization
2007 Name is Empty
2008 Prompt is Empty
2009 Invalid Type
2010 Not Implemented
2011 Assistant General Error
2012 Assistant Not Implemented
2013 Revision is Empty
2014 Assistant Revision Not Found
2015 Assistant Revision Update Error
2016 AIModel Id for %1 %2
2017 Search Profile General Error
2018 Vector Store Not Found
2019 Index Profile General Error
2020 Search Profile Already Exists
2021 Document Not Found
2022 Invalid DocumentId
2023 Document General Error
2024 Search Profile Invalid
2025 Document Name Not Provided
2026 Verb Not Supported
2027 Document Extension Invalid
2028 Invalid File Size
2029 Project name already exists
2030 Assistant name already exists
2031 Assistant not in Project
2032 The status value is unexpected
2033 AssistantId is empty
2034 Metadata Id not found
2035 GXquery APIError
2036 Metadata delete failed (%1)
2037 Input data is missing (required %1)
2038 Invalid access token
2039 Assistant is in use: %1
2040 Assistant Intent Not Found
2041 The assistant specified is of a different type than expected.
2042 Invalid Search Type
2043 Invalid Retriever Search Type
2044 Organization or Project mismatch: verify the provided authorization
2045 The provided authorization is not valid for this endpoint
2046 Organization mismatch: verify the provided authorization
2047 AWS Knowledge Bases can only be queried
2048 Could not connect to RAG API endpoint
2049 Invalid input data
2050 Multiple References To Index Namespace
2070 Invalid billing project
2500 The description already exists.
2501 A description must be provided.
2504 Wait Timed Out
3000 Data Analyst APIError
3001 Froid APIError
3002 The assistant cannot be found on the Froid instance
3003 The assistant is currently being updated and is not yet available
3004 Error validating metadata: each uploaded file requires related JSON metadata and vice versa
3005 Error validating metadata: no metadata was found for file %1
3006 Error validating metadata: dataframe name inconsistent for file %1
3007 Error validating metadata: column explanation %1 must be in lowercase format
3008 Invalid file extension
3100 An error has occurred while obtaining a new access token.
3101 Flow chat API Error
3102 The bot could not be found
3200 Usage limit could not be found.
3201 Hard limit cannot be less than the soft limit.
3202 There is already an active defined limit.
3203 Limits cannot be specified as decimals for the selected unit.
3204 There is no active limit defined.
3205 The operation cannot be executed for the selected resource.
3206 This operation is only permitted for an active usage limit.
4000 Not Found
4001 Bad Request
4002 Duplicated
4030 You do not have the required permissions to perform this action.
4044 Organization quota limits only support costs as QuotaLimitUnit, not requests
4045 The hard Limit must be at least:
4046 Exceeded the organization's defined hard limit
4100 Saia Chat User Agent Interaction Not Found / UIConfigurationNotFound
4101 Saia Chat User Agent Tool Interaction Not Found / Missing Configuration
4102 Saia Chat User Agent Process Interaction Not Found
5403 Workitem status does not support operation
5000 Query execution returned too many rows
5001 Query execution returned too few rows
5002 Query execution returned too many fields
5003 Query execution returned too few fields
5004 Parameter Invalid Value
5005 System Parameter Save Failed
8000 Invalid Character In Name
8001 Public Name Required
8002 Invalid Public Name
8003 Invalid Strategy
8004 Invalid Agent Peer
8005 Inactive Entity
8006 Invalid Resource
8007 No Resources
8008 Revision Not Found
8009 Newer Revisions
8010 Revision Is Published
8014 Process Instance Subject Truncated
8015 Logical Delete
8016 Entity Id Is Required
8017 Tool Parameter Requires Value
8018 Tool APIDefinition Is Missing
8019 Tool Parameter Requires Key
8020 Tool Parameter Value Not Set
8021 Tool Parameter Duplicated
8022 Agent not found
8023 KB Is Required
8024 LiteLLM General Error
8025 LiteLLM Not Found Error
8026 LiteLLM Unauthorized Error
8027 Omni Parser General Error
8028 Document Download Error
8029 Max Runs Reached
8030 Invalid Sharing Scope
8031 Invalid Access Scope
8032 Invalid Guard Rail Type
8033 Missing Guard Rail Name
8034 Guard Rail Not In Same Project
Last update: December 2025 | © GeneXus. All rights reserved. GeneXus Powered by Globant