Troubleshooting
This guide helps you diagnose common issues with the Flagsmith API, SDKs, and self-hosted deployments. Start from the symptom you are seeing, and follow the steps to resolve it.
What are you seeing?
HTTP errors from the API
Getting 4xx or 5xx responses when calling the Flagsmith API from your application code, an SDK, or a direct HTTP
request.
SDK behaving unexpectedly
Flags are stale, default values are returned when they shouldn't be, or trait-based targeting isn't matching the way you expect.
Diagnose SDK issues →Self-hosted runtime problems
The task processor isn't picking up jobs, a database migration failed on upgrade, or your API containers are returning intermittent errors.
Diagnose self-hosted issues →tip
If your issue isn't covered here, check the FAQ or contact support.