kernel 0.126.0__tar.gz → 0.128.0__tar.gz

kernel-0.128.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.128.0"
+}

{kernel-0.126.0 → kernel-0.128.0}/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.128.0](https://github.com/kernel/kernel-python-sdk/compare/v0.127.0...v0.128.0) (2026-10-19)
+
+
+### Features
+
+* Add browser location session policy ([48fd526](https://github.com/kernel/kernel-python-sdk/commit/48fd52646ea0dafcecd637d2cae6c71a19318f7a))
+* chore(stlc): seal custom-code tracking files ([457e6c1](https://github.com/kernel/kernel-python-sdk/commit/457e6c14bd10df055044c2b48704b64d90ca8aff))
+* Fence browser allowlist updates with revision checks ([a9ab0d3](https://github.com/kernel/kernel-python-sdk/commit/a9ab0d3955c3535458f99f117fae744e34c66930))
+* Support existing-user AgentCard wallet imports ([c1a6765](https://github.com/kernel/kernel-python-sdk/commit/c1a6765c789f5ed7585a55780f83435cc8c5d4ee))
+
+## [0.127.0](https://github.com/kernel/kernel-python-sdk/compare/v0.126.0...v0.127.0) (2026-10-16)
+
+
+### Features
+
+* Add atomic preconditions to pool network updates ([9869c91](https://github.com/kernel/kernel-python-sdk/commit/9869c911414a8be186a1a64682487fd38423fb92))
+* Add passkey credential fields and PATCH field add/remove ([84a69ad](https://github.com/kernel/kernel-python-sdk/commit/84a69ad74c46ddcdd87acd88a23dd5330adf555b))
+* Allow replacing vault cards whose provider outcome is unknown ([30f88e1](https://github.com/kernel/kernel-python-sdk/commit/30f88e18b045f3fedbe1bd79d3125db105dd725f))
+* chore(stlc): seal custom-code tracking files ([5a62113](https://github.com/kernel/kernel-python-sdk/commit/5a621135bad2661c79068027773ff32b4e14e0c9))
+* Classify text captchas as token tasks and Binance as a provider ([84f71b8](https://github.com/kernel/kernel-python-sdk/commit/84f71b89f84dea25464cbc22ed92786d73083419))
+* Deliver Kernel card details through fill ([eed3e7b](https://github.com/kernel/kernel-python-sdk/commit/eed3e7ba06c46d3cfa6048d9f02c3d8fff6046e6))
+* Raise Kernel card amount cap to $10,000 ([483f331](https://github.com/kernel/kernel-python-sdk/commit/483f3312824d07e5f315afe0ce5058d4fc4a6e99))
+* Remove Link expires_at, return 400 for missing credential values, and log fill failures ([766dd6e](https://github.com/kernel/kernel-python-sdk/commit/766dd6e961fd36f580540a535cad76e659ecafee))
+
 ## [0.126.0](https://github.com/kernel/kernel-python-sdk/compare/v0.125.0...v0.126.0) (2026-10-14)
 
 

{kernel-0.126.0 → kernel-0.128.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.126.0
+Version: 0.128.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk
@@ -239,9 +239,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    network={},
+    location={},
 )
-print(browser.network)
+print(browser.location)
 ```
 
 ## File uploads

{kernel-0.126.0 → kernel-0.128.0}/README.md

@@ -203,9 +203,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    network={},
+    location={},
 )
-print(browser.network)
+print(browser.location)
 ```
 
 ## File uploads

{kernel-0.126.0 → kernel-0.128.0}/api.md

@@ -117,6 +117,11 @@ Types:
 
 ```python
 from kernel.types import (
+    BrowserAllowlistState,
+    BrowserLocation,
+    BrowserLocationRequest,
+    BrowserLocationSource,
+    BrowserLocationUpdateRequest,
     BrowserMemory,
     BrowserMemoryRequest,
     BrowserNetworkConfig,
@@ -484,11 +489,11 @@ from kernel.types import (
 Methods:
 
 - <code title="post /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">create</a>(\*\*<a href="src/kernel/types/proxy_create_params.py">params</a>) -> <a href="./src/kernel/types/proxy_create_response.py">ProxyCreateResponse</a></code>
-- <code title="get /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">retrieve</a>(id) -> <a href="./src/kernel/types/proxy_retrieve_response.py">ProxyRetrieveResponse</a></code>
-- <code title="patch /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">update</a>(id, \*\*<a href="src/kernel/types/proxy_update_params.py">params</a>) -> <a href="./src/kernel/types/proxy_update_response.py">ProxyUpdateResponse</a></code>
+- <code title="get /proxies/{id_or_name}">client.proxies.<a href="./src/kernel/resources/proxies.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/proxy_retrieve_response.py">ProxyRetrieveResponse</a></code>
+- <code title="patch /proxies/{id_or_name}">client.proxies.<a href="./src/kernel/resources/proxies.py">update</a>(id_or_name, \*\*<a href="src/kernel/types/proxy_update_params.py">params</a>) -> <a href="./src/kernel/types/proxy_update_response.py">ProxyUpdateResponse</a></code>
 - <code title="get /proxies">client.proxies.<a href="./src/kernel/resources/proxies.py">list</a>(\*\*<a href="src/kernel/types/proxy_list_params.py">params</a>) -> <a href="./src/kernel/types/proxy_list_response.py">SyncOffsetPagination[ProxyListResponse]</a></code>
-- <code title="delete /proxies/{id}">client.proxies.<a href="./src/kernel/resources/proxies.py">delete</a>(id) -> None</code>
-- <code title="post /proxies/{id}/check">client.proxies.<a href="./src/kernel/resources/proxies.py">check</a>(id, \*\*<a href="src/kernel/types/proxy_check_params.py">params</a>) -> <a href="./src/kernel/types/proxy_check_response.py">ProxyCheckResponse</a></code>
+- <code title="delete /proxies/{id_or_name}">client.proxies.<a href="./src/kernel/resources/proxies.py">delete</a>(id_or_name) -> None</code>
+- <code title="post /proxies/{id_or_name}/check">client.proxies.<a href="./src/kernel/resources/proxies.py">check</a>(id_or_name, \*\*<a href="src/kernel/types/proxy_check_params.py">params</a>) -> <a href="./src/kernel/types/proxy_check_response.py">ProxyCheckResponse</a></code>
 
 # Extensions
 
@@ -576,6 +581,7 @@ from kernel.types.vaults import (
     CredentialAccountVaultItemRequest,
     CredentialCollectionAction,
     CredentialVaultFieldDefinition,
+    CredentialVaultFieldDefinitionInput,
     CredentialVaultFieldInput,
     CredentialVaultFieldState,
     CredentialVaultFieldType,

{kernel-0.126.0 → kernel-0.128.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.126.0"
+version = "0.128.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{kernel-0.126.0 → kernel-0.128.0}/src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.126.0"  # x-release-please-version
+__version__ = "0.128.0"  # x-release-please-version

{kernel-0.126.0 → kernel-0.128.0}/src/kernel/resources/browser_pools.py

@@ -119,7 +119,8 @@ class BrowserPoolsResource(SyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view. Defaults to false.
 
-          memory: Memory requested for headful browsers in this pool.
+          memory: Memory for browsers in this pool. Headless: 1GiB (default), 2GiB, or 4GiB.
+              Headful: 8GiB (default) or 16GiB.
 
           name: Optional name for the browser pool. Must be unique within the project.
 
@@ -254,11 +255,12 @@ class BrowserPoolsResource(SyncAPIResource):
         *,
         chrome_policy: Dict[str, object] | Omit = omit,
         discard_all_idle: bool | Omit = omit,
+        expected_network: BrowserNetworkConfigParam | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
-        memory: Literal["8GiB", "16GiB"] | Omit = omit,
+        memory: Literal["1GiB", "2GiB", "4GiB", "8GiB", "16GiB"] | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_update_params.Profile | Omit = omit,
@@ -302,6 +304,13 @@ class BrowserPoolsResource(SyncAPIResource):
               configuration until it is discarded (by this flag on a later update, or by
               flushing the pool).
 
+          expected_network: Optional optimistic concurrency precondition. Send the network configuration
+              from the last pool response, or {} when it has no network configuration. The
+              entire update is rejected with 409 stale_network if the saved network differs,
+              checked atomically with the write. Omit for unconditional updates. Explicit
+              empty lists differ from omitted lists; route targets must match the saved
+              references (resolved IDs, not equivalent proxy names).
+
           extensions: If provided, replaces the extension list. Empty array clears all
               previously-selected extensions. Omit this field to leave extensions unchanged.
 
@@ -313,9 +322,9 @@ class BrowserPoolsResource(SyncAPIResource):
 
           kiosk_mode: If provided, replaces whether browsers launch in kiosk mode.
 
-          memory: Memory requested for newly-warmed headful browsers in this pool. Existing
-              browsers retain their original allocation. Use discard_all_idle to replace idle
-              browsers.
+          memory: Memory requested for newly-warmed browsers in this pool: 1GiB, 2GiB, or 4GiB for
+              headless, 8GiB or 16GiB for headful. Existing browsers retain their original
+              allocation. Use discard_all_idle to replace idle browsers.
 
           name: If provided, replaces the pool name. Empty string is a no-op; the pool name
               cannot be cleared or reset to empty once assigned.
@@ -397,6 +406,7 @@ class BrowserPoolsResource(SyncAPIResource):
                 {
                     "chrome_policy": chrome_policy,
                     "discard_all_idle": discard_all_idle,
+                    "expected_network": expected_network,
                     "extensions": extensions,
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,
@@ -776,7 +786,8 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view. Defaults to false.
 
-          memory: Memory requested for headful browsers in this pool.
+          memory: Memory for browsers in this pool. Headless: 1GiB (default), 2GiB, or 4GiB.
+              Headful: 8GiB (default) or 16GiB.
 
           name: Optional name for the browser pool. Must be unique within the project.
 
@@ -911,11 +922,12 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         *,
         chrome_policy: Dict[str, object] | Omit = omit,
         discard_all_idle: bool | Omit = omit,
+        expected_network: BrowserNetworkConfigParam | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
         fill_rate_per_minute: int | Omit = omit,
         headless: bool | Omit = omit,
         kiosk_mode: bool | Omit = omit,
-        memory: Literal["8GiB", "16GiB"] | Omit = omit,
+        memory: Literal["1GiB", "2GiB", "4GiB", "8GiB", "16GiB"] | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
         profile: browser_pool_update_params.Profile | Omit = omit,
@@ -959,6 +971,13 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               configuration until it is discarded (by this flag on a later update, or by
               flushing the pool).
 
+          expected_network: Optional optimistic concurrency precondition. Send the network configuration
+              from the last pool response, or {} when it has no network configuration. The
+              entire update is rejected with 409 stale_network if the saved network differs,
+              checked atomically with the write. Omit for unconditional updates. Explicit
+              empty lists differ from omitted lists; route targets must match the saved
+              references (resolved IDs, not equivalent proxy names).
+
           extensions: If provided, replaces the extension list. Empty array clears all
               previously-selected extensions. Omit this field to leave extensions unchanged.
 
@@ -970,9 +989,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           kiosk_mode: If provided, replaces whether browsers launch in kiosk mode.
 
-          memory: Memory requested for newly-warmed headful browsers in this pool. Existing
-              browsers retain their original allocation. Use discard_all_idle to replace idle
-              browsers.
+          memory: Memory requested for newly-warmed browsers in this pool: 1GiB, 2GiB, or 4GiB for
+              headless, 8GiB or 16GiB for headful. Existing browsers retain their original
+              allocation. Use discard_all_idle to replace idle browsers.
 
           name: If provided, replaces the pool name. Empty string is a no-op; the pool name
               cannot be cleared or reset to empty once assigned.
@@ -1054,6 +1073,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                 {
                     "chrome_policy": chrome_policy,
                     "discard_all_idle": discard_all_idle,
+                    "expected_network": expected_network,
                     "extensions": extensions,
                     "fill_rate_per_minute": fill_rate_per_minute,
                     "headless": headless,

{kernel-0.126.0 → kernel-0.128.0}/src/kernel/resources/browsers/browsers.py

@@ -116,8 +116,10 @@ from ...types.browser_proxy_config_param import BrowserProxyConfigParam
 from ...types.browser_network_config_param import BrowserNetworkConfigParam
 from ...types.browser_network_update_param import BrowserNetworkUpdateParam
 from ...types.shared_params.browser_profile import BrowserProfile
+from ...types.browser_location_request_param import BrowserLocationRequestParam
 from ...types.shared_params.browser_viewport import BrowserViewport
 from ...types.shared_params.browser_extension import BrowserExtension
+from ...types.browser_location_update_request_param import BrowserLocationUpdateRequestParam
 
 __all__ = ["BrowsersResource", "AsyncBrowsersResource"]
 
@@ -195,6 +197,7 @@ class BrowsersResource(SyncAPIResource):
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        location: BrowserLocationRequestParam | Omit = omit,
         memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
@@ -239,7 +242,12 @@ class BrowsersResource(SyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          memory: Memory for a headful, non-GPU browser session. Defaults to 8GiB.
+          location: Optional session-only timezone and locale overrides. Each omitted field uses the
+              default for the browser's region. start_url opens once the location applies.
+
+          memory:
+              Memory for a non-GPU browser. Headless: 1GiB (default), 2GiB, or 4GiB. Headful:
+              8GiB (default) or 16GiB.
 
           name: Optional human-readable name for the browser session, used to find it later in
               the dashboard. Must be unique among active sessions within the project. Can be
@@ -331,6 +339,7 @@ class BrowsersResource(SyncAPIResource):
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "location": location,
                     "memory": memory,
                     "name": name,
                     "network": network,
@@ -402,6 +411,7 @@ class BrowsersResource(SyncAPIResource):
         id_or_name: str,
         *,
         disable_default_proxy: bool | Omit = omit,
+        location: BrowserLocationUpdateRequestParam | Omit = omit,
         name: Optional[str] | Omit = omit,
         network: BrowserNetworkUpdateParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -425,6 +435,14 @@ class BrowsersResource(SyncAPIResource):
           disable_default_proxy: If true, stealth browsers connect directly instead of using the default stealth
               proxy. Deprecated in favor of proxy.mode.
 
+          location: Session-only timezone and locale overrides. Omit the object or a field to leave
+              it unchanged; set a string to override; set null to clear that field and use the
+              browser region's default. A browser that cannot change location refuses the
+              request before anything changes. The location applies after the request's other
+              changes, and start_url opens once it has applied. If applying it fails, the
+              other changes and the saved override remain and start_url does not open; retry
+              the request to apply both.
+
           name: Human-readable name for the browser session. Omit to leave unchanged, set to an
               empty string to clear the name. When set, must be unique among active sessions
               within the project.
@@ -476,6 +494,7 @@ class BrowsersResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "disable_default_proxy": disable_default_proxy,
+                    "location": location,
                     "name": name,
                     "network": network,
                     "profile": profile,
@@ -910,6 +929,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
+        location: BrowserLocationRequestParam | Omit = omit,
         memory: BrowserMemoryRequest | Omit = omit,
         name: str | Omit = omit,
         network: BrowserNetworkConfigParam | Omit = omit,
@@ -954,7 +974,12 @@ class AsyncBrowsersResource(AsyncAPIResource):
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          memory: Memory for a headful, non-GPU browser session. Defaults to 8GiB.
+          location: Optional session-only timezone and locale overrides. Each omitted field uses the
+              default for the browser's region. start_url opens once the location applies.
+
+          memory:
+              Memory for a non-GPU browser. Headless: 1GiB (default), 2GiB, or 4GiB. Headful:
+              8GiB (default) or 16GiB.
 
           name: Optional human-readable name for the browser session, used to find it later in
               the dashboard. Must be unique among active sessions within the project. Can be
@@ -1046,6 +1071,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
+                    "location": location,
                     "memory": memory,
                     "name": name,
                     "network": network,
@@ -1117,6 +1143,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
         id_or_name: str,
         *,
         disable_default_proxy: bool | Omit = omit,
+        location: BrowserLocationUpdateRequestParam | Omit = omit,
         name: Optional[str] | Omit = omit,
         network: BrowserNetworkUpdateParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
@@ -1140,6 +1167,14 @@ class AsyncBrowsersResource(AsyncAPIResource):
           disable_default_proxy: If true, stealth browsers connect directly instead of using the default stealth
               proxy. Deprecated in favor of proxy.mode.
 
+          location: Session-only timezone and locale overrides. Omit the object or a field to leave
+              it unchanged; set a string to override; set null to clear that field and use the
+              browser region's default. A browser that cannot change location refuses the
+              request before anything changes. The location applies after the request's other
+              changes, and start_url opens once it has applied. If applying it fails, the
+              other changes and the saved override remain and start_url does not open; retry
+              the request to apply both.
+
           name: Human-readable name for the browser session. Omit to leave unchanged, set to an
               empty string to clear the name. When set, must be unique among active sessions
               within the project.
@@ -1191,6 +1226,7 @@ class AsyncBrowsersResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "disable_default_proxy": disable_default_proxy,
+                    "location": location,
                     "name": name,
                     "network": network,
                     "profile": profile,

{kernel-0.126.0 → kernel-0.128.0}/src/kernel/resources/proxies.py

@@ -105,7 +105,7 @@ class ProxiesResource(SyncAPIResource):
 
     def retrieve(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -115,7 +115,10 @@ class ProxiesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ProxyRetrieveResponse:
         """
-        Retrieve a proxy in the resolved project by ID.
+        Retrieve a proxy in the resolved project by ID or exact name using the database
+        collation. IDs take precedence when a value matches both an ID and a name. Proxy
+        names are not unique; an ambiguous name returns a 400 response with code
+        ambiguous_proxy_name.
 
         Args:
           extra_headers: Send extra headers
@@ -126,10 +129,10 @@ class ProxiesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._get(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -138,7 +141,7 @@ class ProxiesResource(SyncAPIResource):
 
     def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -150,10 +153,8 @@ class ProxiesResource(SyncAPIResource):
     ) -> ProxyUpdateResponse:
         """Update a proxy's name.
 
-        Proxy names are not unique and are not ID-or-name
-        addressable on this endpoint; duplicate names are allowed. Name-based
-        session-create lookups can remain ambiguous until callers resolve proxies by ID
-        or the API adds a stronger uniqueness contract.
+        Proxy names are not unique and duplicate names are
+        allowed.
 
         Args:
           name: New proxy name. Proxy names are trimmed and length-checked only; duplicates are
@@ -167,10 +168,10 @@ class ProxiesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._patch(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             body=maybe_transform({"name": name}, proxy_update_params.ProxyUpdateParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -238,7 +239,7 @@ class ProxiesResource(SyncAPIResource):
 
     def delete(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -263,11 +264,11 @@ class ProxiesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -276,7 +277,7 @@ class ProxiesResource(SyncAPIResource):
 
     def check(
         self,
-        id: str,
+        id_or_name: str,
         *,
         url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -317,10 +318,10 @@ class ProxiesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return self._post(
-            path_template("/proxies/{id}/check", id=id),
+            path_template("/proxies/{id_or_name}/check", id_or_name=id_or_name),
             body=maybe_transform({"url": url}, proxy_check_params.ProxyCheckParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -406,7 +407,7 @@ class AsyncProxiesResource(AsyncAPIResource):
 
     async def retrieve(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -416,7 +417,10 @@ class AsyncProxiesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ProxyRetrieveResponse:
         """
-        Retrieve a proxy in the resolved project by ID.
+        Retrieve a proxy in the resolved project by ID or exact name using the database
+        collation. IDs take precedence when a value matches both an ID and a name. Proxy
+        names are not unique; an ambiguous name returns a 400 response with code
+        ambiguous_proxy_name.
 
         Args:
           extra_headers: Send extra headers
@@ -427,10 +431,10 @@ class AsyncProxiesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._get(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -439,7 +443,7 @@ class AsyncProxiesResource(AsyncAPIResource):
 
     async def update(
         self,
-        id: str,
+        id_or_name: str,
         *,
         name: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -451,10 +455,8 @@ class AsyncProxiesResource(AsyncAPIResource):
     ) -> ProxyUpdateResponse:
         """Update a proxy's name.
 
-        Proxy names are not unique and are not ID-or-name
-        addressable on this endpoint; duplicate names are allowed. Name-based
-        session-create lookups can remain ambiguous until callers resolve proxies by ID
-        or the API adds a stronger uniqueness contract.
+        Proxy names are not unique and duplicate names are
+        allowed.
 
         Args:
           name: New proxy name. Proxy names are trimmed and length-checked only; duplicates are
@@ -468,10 +470,10 @@ class AsyncProxiesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._patch(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             body=await async_maybe_transform({"name": name}, proxy_update_params.ProxyUpdateParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -539,7 +541,7 @@ class AsyncProxiesResource(AsyncAPIResource):
 
     async def delete(
         self,
-        id: str,
+        id_or_name: str,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -564,11 +566,11 @@ class AsyncProxiesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
-            path_template("/proxies/{id}", id=id),
+            path_template("/proxies/{id_or_name}", id_or_name=id_or_name),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -577,7 +579,7 @@ class AsyncProxiesResource(AsyncAPIResource):
 
     async def check(
         self,
-        id: str,
+        id_or_name: str,
         *,
         url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -618,10 +620,10 @@ class AsyncProxiesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not id_or_name:
+            raise ValueError(f"Expected a non-empty value for `id_or_name` but received {id_or_name!r}")
         return await self._post(
-            path_template("/proxies/{id}/check", id=id),
+            path_template("/proxies/{id_or_name}/check", id_or_name=id_or_name),
             body=await async_maybe_transform({"url": url}, proxy_check_params.ProxyCheckParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout