Troubleshooting

401 AUTH_ERROR

Cause:

• Missing API key

• Invalid or revoked API key

Fix:

• Verify Authorization: Bearer <API_KEY> or X-API-Key

• Check you are using the correct environment key

400 VALIDATION_ERROR

Cause:

• Missing required fields

• Invalid request payload shape

Fix:

• Validate request body before calling Veilio

• Check endpoint-specific payload examples

403 PLAN_LIMIT

Cause:

• Plan limit reached

Fix:

• Check current usage

• Reduce request volume or contact Veilio for plan upgrade

429 RATE_LIMIT_ERROR

Cause:

• Too many requests in a short period

Fix:

• Read and honor Retry-After

• Add exponential backoff

• Use bulk endpoints where applicable

500 INTERNAL_ERROR

Cause:

• Temporary server-side issue

Fix:

• Retry with backoff

• Log request context in your system

• Contact Veilio support if issue persists

If you have any issues or suggestions, feel free to reach out to us here: https://veilio.xyz/contact