FastGPT Error Code Reference (122 codes)

FastGPT Error Code Reference

How to use this table

API error responses carry a code and a statusText. This page lists the 122 error codes defined in the open-source repository, grouped by module, so either field can be used to look up which module raised the error and which message it maps to. Verified 2026-09-09.

Use the first three digits of code to locate the module band, then find the entry in that module's table. statusText is the stable identifier and is more reliable than code across versions.

Columns

Three things to know before using this table

1. Two pairs of modules share the same base code band, so code alone does not identify the module.

For values in these bands, statusText is required to determine the source module.

2. 1 error code does not sit inside its module's base band.

This entry sets its code directly in the definition, so deriving it from the band will not find it.

3. 2 statusText values are declared in an enum but have no code definition.

These identifiers can be referenced in code, but the error map does not contain them, so no code or message is returned at runtime.

dataset module (13 codes, base band 501000)

app module (5 codes, base band 502000)

chat module (2 codes, base band 504000)

openapi module (3 codes, base band 506000)

user module (10 codes, base band 503000)

team module (45 codes, base band 500000)

skill module (17 codes, base band 509000)

sandbox module (4 codes, base band 510000)

plugin module (2 codes, base band 508000)

outLink module (4 codes, base band 505000)

s3 module (3 codes, base band 510000)

common module (8 codes, base band 507000)

system module (5 codes, base band 509000)

coupon module (1 codes, base band 512000)

When this table goes out of date

1. A new error code inserted mid-array shifts every code after it. Checks based on the numeric code can break after an upgrade; use statusText instead.
2. The commercial edition has its own error definitions. This table covers the open-source repository only.
3. Message keys map to text that changes with the language pack. This table gives the key, not the wording.
4. Values declared in an enum without a code may get one in a later version.

Next steps

The tables above can be checked against the open-source repository. If a specific deployment needs to be assessed against these values, contact sales for support; the cloud service can be used directly without preparing the environment first.

• Contact sales: assess your deployment against these values
• Get started: use the cloud service and skip environment setup
• Pricing: compare what each form covers

Codes taken from the error definition files of 14 modules, verified 2026-09-09.