Add REST API auth FAQ entry, expand screenshot auth examples, update examples page

Author: kathayl

src/content/docs/browser-rendering/examples.mdx

@@ -29,7 +29,7 @@ Use these [REST API](/browser-rendering/rest-api/) examples to perform quick, co
     />
     <LinkCard
         title="Take a screenshot of an authenticated page"
-        description="Capture a screenshot of a webpage that requires login by providing session cookies."
+        description="Capture a screenshot of a webpage that requires login using cookies, HTTP Basic Auth, or custom headers."
         href="/browser-rendering/rest-api/screenshot-endpoint/#capture-a-screenshot-of-an-authenticated-page"
     />
     <LinkCard

src/content/docs/browser-rendering/faq.mdx

@@ -82,6 +82,50 @@ Not yet. Local development currently has the following limitation(s):
 
 <Render file="remote-binding-note" product="workers" />
 
+### How do I render authenticated pages using the REST API?
+
+If the page you are rendering requires authentication, you can pass credentials using one of the following methods. These parameters work with all [REST API](/browser-rendering/rest-api/) endpoints.
+
+HTTP Basic Auth:
+
+```json
+{
+  "authenticate": {
+    "username": "user",
+    "password": "pass"
+  }
+}
+```
+
+Cookie-based authentication:
+
+```json
+{
+  "cookies": [
+    {
+      "name": "session_id",
+      "value": "abc123",
+      "domain": "example.com",
+      "path": "/",
+      "secure": true,
+      "httpOnly": true
+    }
+  ]
+}
+```
+
+Token-based authentication:
+
+```json
+{
+  "setExtraHTTPHeaders": {
+    "Authorization": "Bearer your-token"
+  }
+}
+```
+
+For complete worked examples of all three methods, refer to [Capture a screenshot of an authenticated page](/browser-rendering/rest-api/screenshot-endpoint/#capture-a-screenshot-of-an-authenticated-page).
+
 ### Will Browser Rendering be detected by Bot Management?
 
 Yes, Browser Rendering requests are always identified as bot traffic by Cloudflare. Cloudflare does not enforce bot protection by default — that is the customer's choice.

src/content/docs/browser-rendering/rest-api/screenshot-endpoint.mdx

@@ -90,7 +90,11 @@ Visit the [Browser Rendering API reference](/api/resources/browser_rendering/sub
 
 ### Capture a screenshot of an authenticated page
 
-Some webpages require authentication before you can view their content. To capture a screenshot of these pages, you must provide valid session cookies. The following example navigates to a page that requires login. By providing a valid cookie in the `cookies` array, Browser Rendering will be able to access the secure content in order to capture the screenshot.
+Some webpages require authentication before you can view their content. Browser Rendering supports three authentication methods, which work across all [REST API](/browser-rendering/rest-api/) endpoints. For a quick reference of all methods, refer to [How do I render authenticated pages using the REST API?](/browser-rendering/faq/#how-do-i-render-authenticated-pages-using-the-rest-api).
+
+#### Cookie-based authentication
+
+Provide valid session cookies to access pages that require login:
 
 ```bash
 curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
@@ -110,6 +114,41 @@ curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-
   --output "authenticated-screenshot.png"
 ```
 
+#### HTTP Basic Auth
+
+Use the `authenticate` parameter for pages behind HTTP Basic Authentication:
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/protected-page",
+    "authenticate": {
+      "username": "user",
+      "password": "pass"
+    }
+  }' \
+  --output "authenticated-screenshot.png"
+```
+
+#### Token-based authentication
+
+Add custom authorization headers using `setExtraHTTPHeaders`:
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/protected-page",
+    "setExtraHTTPHeaders": {
+      "Authorization": "Bearer your-token"
+    }
+  }' \
+  --output "authenticated-screenshot.png"
+```
+
 ### Navigate and capture a full-page screenshot
 
 Navigate to `https://cloudflare.com/`, change the page size (`viewport`) and wait until there are no active network connections (`waitUntil`) or up to a maximum of `4500ms` (`timeout`) before capturing a `fullPage` screenshot.