Publish or update a preview port
Adds a port to the sandbox’s published set, optionally with an explicit
public or private mode. On a new row, omitted access inherits the
sandbox’s current preview_access default. On an existing row, omitted
access preserves that row’s current mode; only an explicit value
changes it. An explicit private publication is rejected while the
sandbox remains legacy_public, because legacy routing exposes all ports.
Authorizations
Path Parameters
The unique identifier of the sandbox.
Public sandbox ID: a bare UUID, or the region-tagged form sb-<region>-<uuid> (e.g. sb-use-1b4e28ba-…). Treat as an opaque string; the tagged form routes the request to the sandbox's home region. Endpoints accept both forms interchangeably.
^(sb-[a-z0-9]+-)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Body
Port to publish. Port 49983 is reserved for Superserve's sandbox service.
1024 <= x <= 65535Explicit per-port mode. When omitted for a new row, inherits the sandbox preview_access default. When omitted for an existing row, preserves that row's current mode.
public, private Response
Published port
Published port. Port 49983 is reserved for Superserve's sandbox service.
1024 <= x <= 65535Independent access mode for this published port. Requests to a
private port must present its preview token using the header named
by the token-mint response's header field, the signed-link query
parameter named by query_param, or the cookie established by a
successful signed-link GET bootstrap.
public, private Durable generation used to scope credentials for this port. Rotation, access changes, and unpublish/re-publish advance it.
x >= 1