Endpoint
Source: src/cwsandbox/_types.py:219
Product endpoint on a PUBLIC service. Set at create time.
HTTPS + OPEN: CoreWeave terminates TLS. A URL in
Sandbox.service_urls means the hostname was assigned, not that
the app is listening yet. auth is required.
TLS_PASSTHROUGH: the platform forwards TLS by SNI to the container.
auth and request_timeout_seconds must be unset. The assigned
target is host:port on Sandbox.service_addresses. Use the
host as TLS SNI. The workload owns certs.
request_timeout_seconds is the server-side HTTPS request clock on
this product endpoint (504 while the sandbox stays alive). It is not
Sandbox.run(request_timeout_seconds=...), which is the client RPC
deadline. This client only requires an int (or None).
Attributes
auth (EndpointAuth | str | None) : OPEN when kind is HTTPS. Must be omitted for TLS
passthrough.request_timeout_seconds (int | None) : Seconds before the platform closes an
in-flight HTTPS request. None or 0 selects the
platform default (15s on serverless). The server accepts
0 or [15, 900]. On create-from-template, 0 is
replace-on-presence and does not clear a template timeout
back to the platform default. Must be unset for TLS
passthrough.
EndpointAuth
Source: src/cwsandbox/_types.py:213
EndpointKind
Source: src/cwsandbox/_types.py:206
HTTPS = 'https'TLS_PASSTHROUGH = 'tls_passthrough'
HttpsEndpointStatus
Source: src/cwsandbox/_types.py:278
Applied HTTPS product endpoint echoed on Sandbox.service_endpoints.
request_timeout_seconds is the effective server-side clock (15 when
create omitted or sent 0). url is empty when the API suppresses
it (terminal sandboxes). This is not Sandbox.run(request_timeout_seconds=...).
TlsPassthroughEndpointStatus
Source: src/cwsandbox/_types.py:303
Applied TLS passthrough endpoint echoed on Sandbox.service_addresses.
address is host:port. Use the host as TLS SNI. The workload
owns certs. Empty after stop.
Last modified on September 17, 2026
