SetProjectGatewayURL
POST/admin/v1/project-gateways/:id/url
This endpoint has been deprecated and may be replaced or removed in future versions of the API.
Set the customer-facing URL/hostname for a project gateway.
The hostname (host part of the URL) must be globally UNIQUE across all project gateways in the platform; setting a hostname already bound to a different gateway is rejected with ALREADY_EXISTS.
Behavior change (strict isolation): once any gateway in a data plane's workspace has its URL set, that data plane serves ONLY per-gateway host-scoped routes -- the default all-models route is suppressed, so clients must call the gateway hostname rather than the workspace's shared URL.
Best practice: attach a project and assign its models BEFORE setting the
URL. Setting a URL on a gateway with no attached project (or whose project
has no assigned models) makes the gateway reachable but it will return 404
for every request until a project with assigned models is attached. The
response surfaces any such condition in the warnings field.
Deprecated (fraser#8586): a data plane reports its own address from global.gateway.hostnames in its serve-helm values, and the management plane mirrors it read-only. This stays working in 0.6; removal is proposed for 0.8.
Request
Responses
- 200
Success