From f6f02d041d18f636c145c77e586bba72ae753ac5 Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Tue, 7 Jul 2026 21:22:46 +0000
Subject: [PATCH 1/2] Document proxy health check in proxies overview
---
proxies/overview.mdx | 57 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 57 insertions(+)
diff --git a/proxies/overview.mdx b/proxies/overview.mdx
index d62e6d3..8c56123 100644
--- a/proxies/overview.mdx
+++ b/proxies/overview.mdx
@@ -196,6 +196,63 @@ func main() {
```
+## Check proxy health
+
+Before attaching a proxy to a browser session, run a health check to verify credentials and connectivity. This is especially useful right after creation, after rotating credentials, or when a session against the proxy starts failing. Pass an optional `url` to test reachability against a specific target instead of Kernel's default test URLs.
+
+
+```typescript Typescript/Javascript
+import Kernel from '@onkernel/sdk';
+
+const kernel = new Kernel();
+
+const result = await kernel.proxies.check(proxy.id, {
+ url: 'https://example.com',
+});
+console.log(result.last_checked_at, result.ip_address);
+```
+
+```python Python
+from kernel import Kernel
+
+kernel = Kernel()
+
+result = kernel.proxies.check(
+ id=proxy.id,
+ url="https://example.com",
+)
+print(result.last_checked_at, result.ip_address)
+```
+
+```go Go
+package main
+
+import (
+ "context"
+ "fmt"
+
+ "github.com/kernel/kernel-go-sdk"
+)
+
+func main() {
+ ctx := context.Background()
+ client := kernel.NewClient()
+
+ result, err := client.Proxies.Check(ctx, proxy.ID, kernel.ProxyCheckParams{
+ URL: kernel.String("https://example.com"),
+ })
+ if err != nil {
+ panic(err)
+ }
+ fmt.Println(result.LastCheckedAt, result.IPAddress)
+}
+```
+
+
+
+For ISP and datacenter proxies, the exit IP is stable, so a successful check against a `url` reliably indicates that subsequent browser sessions will reach the same target from the same IP. For residential and mobile proxies, the exit node changes between requests, so the check validates credentials and connectivity but does not guarantee that a later session will use the same exit IP. When `url` is provided, the result does not update the proxy's stored health status, since a failure may indicate a problem with the target site rather than the proxy itself.
+
+
## Bypass hosts
Configure specific hostnames to bypass the proxy and connect directly. This is useful for accessing internal services, metadata endpoints, or reducing latency for trusted domains.
From 3ea269b096de1184906c4e58d2b9e38106bb5d11 Mon Sep 17 00:00:00 2001
From: ehfeng <279398+ehfeng@users.noreply.github.com>
Date: Tue, 7 Jul 2026 21:32:08 +0000
Subject: [PATCH 2/2] Shorten proxy health check examples to bare minimum
---
proxies/overview.mdx | 47 +++++++-------------------------------------
1 file changed, 7 insertions(+), 40 deletions(-)
diff --git a/proxies/overview.mdx b/proxies/overview.mdx
index 8c56123..4d7f845 100644
--- a/proxies/overview.mdx
+++ b/proxies/overview.mdx
@@ -198,59 +198,26 @@ func main() {
## Check proxy health
-Before attaching a proxy to a browser session, run a health check to verify credentials and connectivity. This is especially useful right after creation, after rotating credentials, or when a session against the proxy starts failing. Pass an optional `url` to test reachability against a specific target instead of Kernel's default test URLs.
+Before attaching a proxy to a browser session, run a health check to verify credentials and connectivity. Pass an optional `url` to test reachability against a specific target instead of Kernel's default test URLs.
```typescript Typescript/Javascript
-import Kernel from '@onkernel/sdk';
-
-const kernel = new Kernel();
-
-const result = await kernel.proxies.check(proxy.id, {
- url: 'https://example.com',
-});
-console.log(result.last_checked_at, result.ip_address);
+await kernel.proxies.check(proxy.id, { url: 'https://example.com' });
```
```python Python
-from kernel import Kernel
-
-kernel = Kernel()
-
-result = kernel.proxies.check(
- id=proxy.id,
- url="https://example.com",
-)
-print(result.last_checked_at, result.ip_address)
+kernel.proxies.check(id=proxy.id, url="https://example.com")
```
```go Go
-package main
-
-import (
- "context"
- "fmt"
-
- "github.com/kernel/kernel-go-sdk"
-)
-
-func main() {
- ctx := context.Background()
- client := kernel.NewClient()
-
- result, err := client.Proxies.Check(ctx, proxy.ID, kernel.ProxyCheckParams{
- URL: kernel.String("https://example.com"),
- })
- if err != nil {
- panic(err)
- }
- fmt.Println(result.LastCheckedAt, result.IPAddress)
-}
+client.Proxies.Check(ctx, proxy.ID, kernel.ProxyCheckParams{
+ URL: kernel.String("https://example.com"),
+})
```
-For ISP and datacenter proxies, the exit IP is stable, so a successful check against a `url` reliably indicates that subsequent browser sessions will reach the same target from the same IP. For residential and mobile proxies, the exit node changes between requests, so the check validates credentials and connectivity but does not guarantee that a later session will use the same exit IP. When `url` is provided, the result does not update the proxy's stored health status, since a failure may indicate a problem with the target site rather than the proxy itself.
+For ISP and datacenter proxies the exit IP is stable, so a successful check against a `url` reliably indicates that subsequent sessions will reach the same target from the same IP. For residential and mobile proxies the exit node changes between requests, so the check validates credentials and connectivity but not site-specific reachability. When `url` is provided, the result does not update the proxy's stored health status.
## Bypass hosts