GraphQL API Error Codes Overview

Code

Type of Issue

Description

C

Client issues

These are usually issues that can be fixed by clients themselves

S

Server issues

Clients need assistance to resolve the issue

T

Third-party issues

Issues caused during third-party interactions

Code

Type of Issue

E

Error

W

Warning

4 Digit Sequence

Classification of Error

Description

C0001 - C0099

Platform behavior

Errors that come from platform restrictions but could be fixed by clients

C0001 - C0019

API limit Errors

For example: Indicates that a GraphQL query was made with higher complexity than is allowed by the server

C0020 - C0099

TBC

C0100 - C0199

Input Validations

C0100 - 0119

Date-related

Input validation Errors that have to do with dates and times

C0120 - C0139

Field-related

Input validation Errors that have to do with fields

C0140 - C0159

Request Format-related

Input validation Errors that have to do with the request formats

C0160 - C0179

Custom Validations - TBC

C0180 - C0299

TBC

4 Digit Sequence

Classification of Error

Description

S0001 - S0019

Settings Error

Any Error in Platform Settings.
For example, a missing Setting or values of two Settings in conflict with one another

S0020 - S0039

TBC

Error Code

Description

Possible Solutions

C0001E

Indicates that a GraphQL query was made with a higher complexity than is allowed by the server

Simplify the query by reducing:

• nesting 
• requested fields
• or number of records

C0003E

Indicates that a Virtual View is still initializing and data is not yet available

Wait until the Virtual View setup completes and status changes to

`ACTIVE`

C0011E

User has exceeded the allowable number of GraphQL queries in a given time period

Reduce query frequency

C0020E

User lacks required Permissions to execute the query or mutation

• Review the required missing Permissions listed in the Error Message
• Assign a User Role with the missing Permissions

C0100E

User passed a non-UTC date value

Pass a valid UTC date format

C0101E

User is querying on dates without passing

`from`

`to`

Pass at least one of the

`from`

`to`

C0102E

User is querying on dates without passing both

`from`

`to `

Pass both

`from`

`to`

C0103E

Indicates that a query timeframe exceeds allowed max range for the chosen granularity

• Reduce timeframe 
• or change granularity

C0120E

Validation error when entity cannot be found during operation (e.g., delete mutation)

Ensure inputs refer to existing Entities accessible by the User

For example: 

• A User may have access to data for multiple Retailers. Such a User can perform permitted operations on all those Retailers
• Whereas User who have access to a single Retailer will only be allowed to perform the permitted operations for data of that Retailer only

C0121E

Input

`ref`

Verify the input

`ref`

C0122E

Integer field does not allow negative values

Use a positive integer

C0123E

Input field violates a unique constraint

Verify the input field value

C0124E

Indicates that object validation failed (e.g., Inventory Feed)

• Verify that destination attributes are not empty
• Ensure the following attributes are provided:
  • AWS Account ID
  • AWS S3 Bucket Name
• Provide only one AWS Account ID and one S3 Bucket Name

C0125E

User is querying on ranges without passing

`from`

`to`

Pass at least one of the

`from`

`to`

CO127E

Indicates that the system could not find a Retailer Entity for the given Type

Ensure that the provided Type is valid and that a corresponding Retailer Entity exists and is accessible

C0128E

Indicates that multiple Products with the same Reference exist within a Product Catalog

• Ensure Product Reference uniqueness within a Product Catalog
• Or use optional

  `productType`

  input field to identify the target Product (to be updated with the

  `updateProduct`

  mutation)

C0140E

Missing variables in a query or mutation

Pass the required variables in the query

C0141E

Input field value exceeds max character length

• Find the character limit from the documentation 
• Pass a value within this limit

C0160E

Custom validation failed on a specific input field

Review and correct field value per schema custom validations

C0161E

Hash (#) character not allowed in this field input

Remove # character from input

C0162E

The provided timezone is not a valid timezone

Check if the timezone value matches an existing and valid TZ identifier in the Continent/City format 

Error Code

Description

Possible Solutions

S0001E

Indicates that the Entity-level Permission Setting is missing

Raise a support ticket to set the Permission Setting

S0002E

• Indicates a general server failure in processing a GraphQL request
• Indicates that the “Me” query feature has been disabled by account configuration

• Try again later or contact support if the issue persists
• "Me" query can be enabled for the Account by removing the GRAPHQL.DISABLE_GRAPHQL_ME_QUERY Account Setting

S0003E

Indicates that the Account Setting SSO.DETAILS contains invalid JSON values

Update the value using the existing setting API

S0004E

Indicates a failure when trying to create a User in Fluent IDP

Raise a support ticket to investigate

S0005E

Indicates a failure when trying to update a User in Fluent IDP

Raise a support ticket to investigate

S0006E

Indicates that a failure occurred while trying to upsert an Inventory Feed

• Review the Inventory Feed configuration 
• or contact support

S0020E

Indicates an unspecified server-side error

• Retry the request later 
• Contact support if the issue continues

S0030E

Indicates a failure in setting up the Virtual View

Contact support to investigate Virtual View setup issues

S0040E

Indicates a failure while MeQuery extracting username from a JWT access token

• Retry the operation later
• If not resolved, then raise a support ticket to investigate

S0126E

Indicates that Observability features are turned off

Contact support to enable Observability

S0127E

Indicates that Analytics query feature is turned off

Contact support to enable Analytics