WordPress AI Connection Returns 429 Too Many Requests
The client exceeds a request-rate threshold enforced by the application, host or WAF.
Capture the exact sanitized message, HTTP status and response body without including secrets.
Likely causes
- The client exceeds a request-rate threshold enforced by the application, host or WAF.
- Automatic retries repeat the same failing request too quickly and amplify the limit.
- A WAF or security rule blocks the specific REST path, method, payload or authentication pattern.
- The plugin automatically provisions a new Application Password when its previous credential is missing or invalid.
- Origin resources are exhausted or concurrency is too high for the current workload.
Diagnostic sequence
- Capture the exact sanitized message, HTTP status and response body without including secrets.
- Record WordPress, plugin, client, connector and server versions before changing anything.
- Pause automatic retries and repeat one request at a controlled interval.
- Review the exact WAF or security-plugin event for the route, method and rule identifier.
- Inspect sanitized WordPress, PHP, origin and gateway logs around one request identifier.
- Compare credential name, creation date, last-used time and last IP with the observed workflow.
Apply the smallest correction
- Reduce concurrency and retry frequency, then honor any server-provided retry interval.
- Stop automatic retry loops until the underlying failure has been diagnosed.
- Adjust only the verified false-positive WAF rule, path or method instead of disabling protection globally.
- Document who creates, rotates, reuses and revokes the credential, including the trigger for each change.
- Escalate with sanitized, versioned evidence when the behavior remains specific to the plugin.
Verify the result
- A controlled request interval completes without another 429 response.
- The approved narrow read succeeds with a reproducible response.
- The authenticated request resolves to the intended dedicated WordPress user.
- The final record contains versions, evidence, change, verification and rollback information without secrets.
What not to do
- Do not disable the WAF or security plugin globally to bypass one request.
- Do not repeatedly regenerate credentials or retry the same failing request without understanding the lifecycle.
- Do not grant administrator access merely to make a connection test pass.
- Do not expose debug logs or diagnostic endpoints publicly.
- Do not place an Application Password, Authorization header, token or cookie in a prompt, ticket, log excerpt or screenshot.
Frequently asked questions
Should I retry the request until it succeeds?
No. Repeated retries can worsen rate limiting, duplicate non-idempotent actions or hide an unstable upstream. Classify the status and retry only with a bounded policy.
Related guides
- A Security Plugin or WAF Is Blocking the WordPress REST API
- WordPress AI Connection Returns 500, 502 or 503
- Why a WordPress Application Password Keeps Reappearing or Rotating
- Troubleshooting Claude Code or Codex Access to WordPress
- Using the WordPress REST API with an AI Assistant
Sources and verification
This page was checked against the following primary sources. Last source review: .
- RFC 6585: Additional HTTP Status Codes · RFC Editor
- RFC 9110: HTTP Semantics · RFC Editor
- REST API Handbook · WordPress Developer Resources