Create a gateway
Creates a new gateway. Ownership tenant_id is required (JWT claim, or body for platform admins). The slug is optional: when omitted the server generates a unique random slug. If provided it must be a lowercase DNS label and unique. Platform JWT create requires stamped entitlements (tier + caps); tenant JWTs must omit entitlements (422 if sent). With RATE_LIMIT_ENABLED, create returns 409 when the tenant is already at MaxInstances for the effective tier.
A valid request URL is required to generate request examples{
"client_tls": {},
"created_at": "<string>",
"domain": "<string>",
"entitlements": {
"burst_per_min": 123,
"data_plane": "<string>",
"max_instances": 123,
"quota_per_month": 123,
"retention_days": 123,
"tier": "<string>"
},
"hosts": {
"mcp": "<string>",
"proxy": "<string>"
},
"id": "<string>",
"metadata": {},
"session_config": {
"body_param_name": "<string>",
"enabled": true,
"header_name": "<string>"
},
"slug": "<string>",
"status": "<string>",
"store_mode": "<string>",
"telemetry": {
"enable_plugin_traces": true,
"enable_request_traces": true,
"exporters": [
{
"class": "metadata",
"name": "<string>",
"settings": {},
"type": "<string>"
}
],
"extra_params": {},
"header_mapping": {}
},
"updated_at": "<string>",
"version": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Body
Gateway to create
Show child attributes
Show child attributes
Entitlements is required for platform (empty JWT tenant) create and must include full stamped caps. Tenant callers must omit it (422 if sent). When a tenant omits it, the gateway defaults to free or inherits the highest sibling tier.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Slug is optional; when omitted the server generates a unique random slug. If provided it must be a lowercase DNS label.
"acme-prod"
Show child attributes
Show child attributes
TenantID is required ownership for platform (empty JWT) create-for-tenant; tenant JWTs may match or omit it (JWT wins).
Response
Created
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
StoreMode is the gateway's MCP Store curation mode, the same value UpdateGatewayRequest writes. It is derived (never blank) rather than left for readers to dig out of metadata: a reader that missed it there read a gateway as open — the domain default — and showed a curated Store as wide open.
Show child attributes
Show child attributes
A valid request URL is required to generate request examples{
"client_tls": {},
"created_at": "<string>",
"domain": "<string>",
"entitlements": {
"burst_per_min": 123,
"data_plane": "<string>",
"max_instances": 123,
"quota_per_month": 123,
"retention_days": 123,
"tier": "<string>"
},
"hosts": {
"mcp": "<string>",
"proxy": "<string>"
},
"id": "<string>",
"metadata": {},
"session_config": {
"body_param_name": "<string>",
"enabled": true,
"header_name": "<string>"
},
"slug": "<string>",
"status": "<string>",
"store_mode": "<string>",
"telemetry": {
"enable_plugin_traces": true,
"enable_request_traces": true,
"exporters": [
{
"class": "metadata",
"name": "<string>",
"settings": {},
"type": "<string>"
}
],
"extra_params": {},
"header_mapping": {}
},
"updated_at": "<string>",
"version": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}