Overview
API token validation errors in the SearchAtlas Cloudflare Worker typically trace back to one of two root causes: the Worker script was not deployed correctly, or the API token is missing the required permissions. This article explains what to check and what information to have ready so our team can resolve the issue quickly.
Step 1: Confirm You Have the Correct Worker Script
Before troubleshooting token validation, confirm you are using the official SearchAtlas Worker script — not a generic Cloudflare template or an outdated version from a previous installation.
- Log in to your SearchAtlas account and locate the Cloudflare Worker integration section to retrieve the current Worker script. If you are unsure where to find this in your account, our support team can point you to the exact location.
- Do not use a script obtained from a third-party source or one that predates your current SearchAtlas account, as a mismatched script is a common reason token validation fails.
Step 2: Deploy the Script in Cloudflare
Once you have the correct SearchAtlas Worker script, deploy it through your Cloudflare dashboard. Replace any existing Worker code with the latest SearchAtlas script in full, then save and redeploy. Running an outdated script version can cause token validation to fail even if your token permissions are otherwise correct.
After deploying, note the Worker's URL — you will need it when configuring the integration in SearchAtlas.
Step 3: Review Your Cloudflare API Token Permissions
Cloudflare API tokens are permission-scoped. A token that lacks the required permissions will fail SearchAtlas validation. When creating or reviewing your token in the Cloudflare dashboard, ensure it includes the permissions necessary for Cloudflare Worker script deployment and API token validation as required by the SearchAtlas integration.
If you are unsure which permissions are needed, or if the token continues to fail validation after reviewing your setup, our support team can assist you directly.
What to Have Ready When Contacting Support
If you are unable to resolve the validation failure on your own, please have the following information ready before reaching out:
- Your SearchAtlas project name
- The exact error message you are seeing during token validation
- A timestamp of when the error first occurred
- A brief description of any changes made to your Worker script or API token before the issue began
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.