Troubleshooting
Error Reference
A reference guide for error codes and messages you may encounter.
Validation Errors
| Property | Type | Default | Description |
|---|---|---|---|
| REQUIRED_FIELD | Field level | — | A required field was submitted without a value. |
| MIN_LENGTH | Field level | — | Text value is shorter than the configured minLength. |
| MAX_LENGTH | Field level | — | Text value exceeds the configured maxLength. |
| PATTERN_MISMATCH | Field level | — | Value does not match the configured regex pattern. |
| MIN_VALUE | Field level | — | Numeric value is below the configured min. |
| MAX_VALUE | Field level | — | Numeric value exceeds the configured max. |
| INVALID_EMAIL | Field level | — | Email field value is not a valid email address. |
| INVALID_DATE | Field level | — | Date field value is outside the min/max date range. |
API Errors
| Property | Type | Default | Description |
|---|---|---|---|
| 401 Unauthorized | API | — | Invalid or expired authentication token. Re-login. |
| 403 Forbidden | API | — | You do not have permission to perform this action. |
| 404 Not Found | API | — | The requested form, submission, or resource does not exist. |
| 409 Conflict | API | — | A conflict occurred, often a duplicate field name or slug. |
| 422 Unprocessable | API | — | The request payload failed server-side validation. |
| 429 Too Many Requests | API | — | Rate limit exceeded. Wait before retrying. |
| 500 Server Error | API | — | Internal server error. Contact support if persistent. |
Schema Errors
These errors appear in the Developer JSON editor when your form schema is invalid:
| Property | Type | Default | Description |
|---|---|---|---|
| DUPLICATE_NAME | Schema | — | Two or more fields share the same `name` value. |
| MISSING_TYPE | Schema | — | A field object is missing the required `type` property. |
| UNKNOWN_TYPE | Schema | — | The `type` value is not a recognized field type. |
| MISSING_NAME | Schema | — | A field is missing the required `name` property. |
| INVALID_FORMULA | Schema | — | A calculated field's formula expression has a syntax error. |
| CIRCULAR_DEPENDENCY | Schema | — | A calculated field references itself or creates a circular chain. |
Was this helpful?