latestOpenAPI 3.1.02026-08-149289225.1 KB

664536fccd0e

Sandboxes

Replace a live service on a sandbox

put/api/v0beta1/sandboxes/{id}/services/{ref}

Path parameters

idstring required
refstring required

Service reference: its name (default) or row id. Use by to choose.

Service reference: its name (default) or row id. Use by to choose.

Query parameters

by'name' | 'id' | 'ref' | 'name_or_id'

How to interpret the service {ref}: name (default), id, or ref/name_or_id (matches either; rejects ambiguity).

How to interpret the service {ref}: name (default), id, or ref/name_or_id (matches either; rejects ambiguity).

sandbox_by'name' | 'id' | 'ref' | 'name_or_id'

How to interpret the sandbox {id} path param: ref/name_or_id (default; matches an id or a name and rejects an ambiguous match), name, or id.

How to interpret the sandbox {id} path param: ref/name_or_id (default; matches an id or a name and rejects an ambiguous match), name, or id.

Request body

namestring required

Service name: a single DNS label, unique per sandbox.

portinteger required

Container port the service listens on.

url_scheme'http' | 'https' required

URL scheme the gateway serves the service over.

Response

Service replaced.

idstring nullable required
sandbox_idstring required
namestring required
portinteger required
url_scheme'http' | 'https' | 'null' nullable required
protocolstring required
urlstring nullable required
host_portinteger nullable required
source'table' | 'legacy' required
kind'system' | 'user' required