Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions proxies/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -196,6 +196,30 @@ func main() {
```
</CodeGroup>

## Check proxy health

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.

<CodeGroup>
```typescript Typescript/Javascript
await kernel.proxies.check(proxy.id, { url: 'https://example.com' });
```

```python Python
kernel.proxies.check(id=proxy.id, url="https://example.com")
```

```go Go
client.Proxies.Check(ctx, proxy.ID, kernel.ProxyCheckParams{
URL: kernel.String("https://example.com"),
})
```
</CodeGroup>

<Info>
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.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Align datacenter IP rotation guidance

This sentence says datacenter proxies have a stable exit IP and that follow-up sessions will use the same IP, but the existing proxy overview above and proxies/datacenter.mdx both state datacenter proxies rotate per request and recommend ISP/custom for stable IPs. Users checking a target URL for IP allowlists or managed-auth flows will get contradictory guidance and may pick datacenter expecting stability; either update the existing rotation docs if behavior changed or remove datacenter from this claim.

Useful? React with 👍 / 👎.

</Info>

## 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.
Expand Down
Loading