From 44aa9e6f80f63491aa9414c6af3d209d4f18a3e6 Mon Sep 17 00:00:00 2001
From: Andy Dixon <andy@andydixon.com>
Date: Thu, 26 Feb 2026 11:38:56 +0000
Subject: [PATCH] docs: note 429 backoff expectations for provider control
 endpoints

Document that integrations should expect provider-side abuse controls on OAuth control endpoints and handle 429 responses with retry/backoff semantics.
---
 docs/INTEGRATION_GUIDE.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/INTEGRATION_GUIDE.md b/docs/INTEGRATION_GUIDE.md
index 4b80f1f..158276b 100644
--- a/docs/INTEGRATION_GUIDE.md
+++ b/docs/INTEGRATION_GUIDE.md
@@ -138,6 +138,7 @@ try {
 
 - Keep provider URLs in environment variables, not hard-coded.
 - Avoid printing tokens in production pages.
+- Expect `429 Too Many Requests` from provider control endpoints under abuse protection; implement backoff/retry instead of tight loops.
 - Rotate client secrets for confidential clients.
 - Add a unique `nonce` to each OIDC authorisation request.
 - Validate `state` on every callback request.