Skip to main content

Gateway configs

Generated from apiome-rest/openapi.yaml (API version 1.307.0) — do not edit by hand. How to authenticate is on the REST API reference.

Tag: gateway-configs · 2 operations

GET /v1/tenants/{tenant_slug}/gateway-configs​

List gateway configs

Every live gateway config: one per (connector, environment), with its API count, auth and rate-limit posture, declared losses and push-back target (imports:view).

Operation id: list_tenant_gateway_configs_v1_tenants__tenant_slug__gateway_configs_get

Parameters

NameInTypeRequiredDescription
tenant_slugpathstringyesURL-safe tenant slug that scopes the request.
connectorquerystring or nullnoOnly this connector's environments.
authorizationheaderstring or nullnoJWT bearer token for authenticated access (Authorization: Bearer <token>).
X-API-Keyheaderstring or nullnoTenant-scoped API key used as an alternative to JWT bearer authentication.

Responses

StatusDescriptionBody
200Successful response for list gateway configs.application/json GatewayConfigList
422Validation Errorapplication/json HTTPValidationError

GET /v1/tenants/{tenant_slug}/gateway-configs/{ref}​

Read a gateway config

One gateway config, by slug or id, with the APIs its environment serves (imports:view).

pushBack.target is the export target that writes this gateway's format (kong, aws-apigateway, azure-apim, apigee), or null with pushBack.reason unsupported.

Operation id: read_tenant_gateway_config_v1_tenants__tenant_slug__gateway_configs__ref__get

Parameters

NameInTypeRequiredDescription
tenant_slugpathstringyesURL-safe tenant slug that scopes the request.
refpathstringyesPath parameter identifying the ref segment.
authorizationheaderstring or nullnoJWT bearer token for authenticated access (Authorization: Bearer <token>).
X-API-Keyheaderstring or nullnoTenant-scoped API key used as an alternative to JWT bearer authentication.

Responses

StatusDescriptionBody
200Successful response for read a gateway config.application/json GatewayConfigOut
422Validation Errorapplication/json HTTPValidationError

Schemas used​

GatewayConfigList​

The tenant's live gateway configs.

PropertyTypeRequiredDescription
gatewayConfigsarray of GatewayConfigOutyesGateway Configs.

GatewayConfigOut​

A gateway config.

PropertyTypeRequiredDescription
idstringyesStable resource identifier.
slugstringyesURL-safe identifier.
namestringyesHuman-readable name.
connectorGatewayConnectorRefyesConnector.
environmentstringyesEnvironment.
flavorstringyesFlavor.
apiCountintegeryesNumber of api.
postureGatewayPostureyesPosture.
declaredLossesarray of GatewayLossnoDeclared Losses.
pushBackGatewayPushBackyesPush Back.
ownerEntityOwnerRef or nullnoOwner.
apisarray of GatewayServedApinoOn a single read only.
lastSyncedAtstring (date-time) or nullnoLast Synced At.
updatedAtstring (date-time) or nullnoUpdated At.

HTTPValidationError​

Validation error response emitted when request data fails schema checks.

PropertyTypeRequiredDescription
detailarray of ValidationErrornoDetail.