{"openapi":"3.1.0","info":{"title":"Kong Konnect Cloud Gateways (BYOK) API","version":"0.1.0","description":"Kong Konnect Cloud Gateways (BYOK) lets an AI assistant read your own Kong Konnect Cloud Gateways data through the Kong Konnect Cloud Gateways API with a key you supply (Konnect personal or system account access token). Read-only: 11 tools (list_configurations, get_configuration, list_networks, get_network, list_network_configurations, list_provider_accounts, list_custom_domains,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kong-konnect-cloud-gateways.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kong-konnect-cloud-gateways/docs"},"termsOfService":"https://connectorbay.com/byok-kong-konnect-cloud-gateways/terms"},"servers":[{"url":"https://byok-kong-konnect-cloud-gateways.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kong-konnect-cloud-gateways/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_configurations":{"post":{"operationId":"list_configurations","summary":"List Dedicated Cloud Gateway configurations with Kong version, API access mode, linked control plane and data plane grou","description":"List Dedicated Cloud Gateway configurations with Kong version, API access mode, linked control plane and data plane groups. Use for \"Which cloud gateway configurations do we run and which regions are they in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_configurationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_configuration":{"post":{"operationId":"get_configuration","summary":"Get one cloud gateway configuration with its data plane groups (provider, region, state, hostnames, egress IPs). Use for","description":"Get one cloud gateway configuration with its data plane groups (provider, region, state, hostnames, egress IPs). Use for \"What data plane groups does cloud gateway configuration 3c4a5b6d have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"configuration_id":{"description":"Cloud gateway configuration id (UUID) from list_configurations.","maxLength":64,"title":"Configuration Id","type":"string"}},"required":["configuration_id"],"title":"get_configurationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_networks":{"post":{"operationId":"list_networks","summary":"List cloud gateway networks with provider account, region, CIDR block, state and the number of transit gateways and conf","description":"List cloud gateway networks with provider account, region, CIDR block, state and the number of transit gateways and configurations using them. Use for \"Which Kong cloud gateway networks exist and are they ready\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_networksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_network":{"post":{"operationId":"get_network","summary":"Get one cloud gateway network with state details and the provider VPC and subnet ids. Use for \"What is the VPC of Kong n","description":"Get one cloud gateway network with state details and the provider VPC and subnet ids. Use for \"What is the VPC of Kong network prod-net\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"network_id":{"description":"Cloud gateway network id (UUID) from list_networks.","maxLength":64,"title":"Network Id","type":"string"}},"required":["network_id"],"title":"get_networkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_network_configurations":{"post":{"operationId":"list_network_configurations","summary":"List the cloud gateway configurations that reference one network. Use for \"Which gateway configurations use Kong network","description":"List the cloud gateway configurations that reference one network. Use for \"Which gateway configurations use Kong network prod-net\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"network_id":{"description":"Cloud gateway network id (UUID) from list_networks.","maxLength":64,"title":"Network Id","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"required":["network_id"],"title":"list_network_configurationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_provider_accounts":{"post":{"operationId":"list_provider_accounts","summary":"List the cloud provider accounts (for example AWS account ids) Kong provisions cloud gateways in. Use for \"Which cloud p","description":"List the cloud provider accounts (for example AWS account ids) Kong provisions cloud gateways in. Use for \"Which cloud provider accounts do our Kong cloud gateways use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_provider_accountsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_custom_domains":{"post":{"operationId":"list_custom_domains","summary":"List custom domains attached to cloud gateway control planes with state and certificate or SNI ids. Use for \"Which custo","description":"List custom domains attached to cloud gateway control planes with state and certificate or SNI ids. Use for \"Which custom domains are configured on our Kong cloud gateways\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_custom_domainsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_custom_domain_online_status":{"post":{"operationId":"get_custom_domain_online_status","summary":"Check whether a cloud gateway custom domain resolves: returns the CNAME and SSL status. Use for \"Is the custom domain ap","description":"Check whether a cloud gateway custom domain resolves: returns the CNAME and SSL status. Use for \"Is the custom domain api.example.com online on Kong cloud gateway\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"custom_domain_id":{"description":"Cloud gateway custom domain id (UUID) from list_custom_domains.","maxLength":64,"title":"Custom Domain Id","type":"string"}},"required":["custom_domain_id"],"title":"get_custom_domain_online_statusArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_resource_quotas":{"post":{"operationId":"list_resource_quotas","summary":"List the cloud gateway resource quotas of the organization (for example maximum networks or configurations) with current","description":"List the cloud gateway resource quotas of the organization (for example maximum networks or configurations) with current values. Use for \"What cloud gateway quotas does our Konnect organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_resource_quotasArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_add_ons":{"post":{"operationId":"list_add_ons","summary":"List cloud gateway add-ons (for example managed cache) with owner, state and configuration. Use for \"Which cloud gateway","description":"List cloud gateway add-ons (for example managed cache) with owner, state and configuration. Use for \"Which cloud gateway add-ons do we have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many items per page (1 to 1000).","title":"Page Size"},"page_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"title":"list_add_onsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_availability":{"post":{"operationId":"get_availability","summary":"Show which Kong versions, instance types, providers and regions are available for Dedicated Cloud Gateways. Use for \"Whi","description":"Show which Kong versions, instance types, providers and regions are available for Dedicated Cloud Gateways. Use for \"Which regions and instance types can I use for a Kong cloud gateway\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_availabilityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}