{"openapi":"3.1.0","info":{"title":"Confluent Cloud Networking (BYOK) API","version":"0.1.0","description":"Confluent Cloud Networking (BYOK) lets an AI assistant read your own Confluent Cloud Networking data through the Confluent Cloud Networking API with a key you supply (Cloud API key ID). Read-only: 9 tools (list_networks, get_network, list_peerings, list_transit_gateway_attachments, list_private_link_accesses, list_private_link_attachments, list_private_link_attachment_connections, list_gateways,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-confluent-cloud-networking.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-confluent-cloud-networking/docs"},"termsOfService":"https://connectorbay.com/byok-confluent-cloud-networking/terms"},"servers":[{"url":"https://byok-confluent-cloud-networking.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-confluent-cloud-networking/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_networks":{"post":{"operationId":"list_networks","summary":"List the dedicated networks of one environment with cloud, region, CIDR, connection types, zones, phase and DNS domain. ","description":"List the dedicated networks of one environment with cloud, region, CIDR, connection types, zones, phase and DNS domain. Use for \"Which Confluent Cloud networks exist in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"cloud":{"anyOf":[{"enum":["AWS","GCP","AZURE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only networks on this cloud.","title":"Cloud"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only networks in this region.","title":"Region"},"phase":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only networks in this phase, for example READY or PROVISIONING.","title":"Phase"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"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 dedicated network by id: cloud, region, CIDR, connection types, zones, phase, DNS domain and any error. Use for ","description":"Get one dedicated network by id: cloud, region, CIDR, connection types, zones, phase, DNS domain and any error. Use for \"Show details of Confluent Cloud network n-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Network id, for example 'n-abc123'.","maxLength":200,"title":"Id","type":"string"},"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"}},"required":["id","environment"],"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_peerings":{"post":{"operationId":"list_peerings","summary":"List VPC or VNet peerings of one environment with name, network, phase and any error. Use for \"Which peerings does Confl","description":"List VPC or VNet peerings of one environment with name, network, phase and any error. Use for \"Which peerings does Confluent Cloud environment env-abc123 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"network":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only peerings of this network id.","title":"Network"},"phase":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only peerings in this phase.","title":"Phase"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_peeringsArguments","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_transit_gateway_attachments":{"post":{"operationId":"list_transit_gateway_attachments","summary":"List AWS transit gateway attachments of one environment with name, network, phase and any error. Use for \"Which transit ","description":"List AWS transit gateway attachments of one environment with name, network, phase and any error. Use for \"Which transit gateway attachments are in Confluent Cloud environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_transit_gateway_attachmentsArguments","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_private_link_accesses":{"post":{"operationId":"list_private_link_accesses","summary":"List private link accesses (cloud accounts allowed to reach a network by private link) of one environment with name, net","description":"List private link accesses (cloud accounts allowed to reach a network by private link) of one environment with name, network, phase and any error. Use for \"Which private link accesses are set up in Confluent Cloud environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_private_link_accessesArguments","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_private_link_attachments":{"post":{"operationId":"list_private_link_attachments","summary":"List private link attachments of one environment with name, cloud, region, phase and DNS domain. Use for \"Which private ","description":"List private link attachments of one environment with name, cloud, region, phase and DNS domain. Use for \"Which private link attachments exist in Confluent Cloud environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_private_link_attachmentsArguments","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_private_link_attachment_connections":{"post":{"operationId":"list_private_link_attachment_connections","summary":"List the connections made to private link attachments of one environment, optionally for one attachment, with name, atta","description":"List the connections made to private link attachments of one environment, optionally for one attachment, with name, attachment, phase and any error. Use for \"Which connections use private link attachment platt-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"private_link_attachment":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only connections of this private link attachment id.","title":"Private Link Attachment"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_private_link_attachment_connectionsArguments","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_gateways":{"post":{"operationId":"list_gateways","summary":"List network gateways of one environment with name, cloud config kind, region and phase. Use for \"Which Confluent Cloud ","description":"List network gateways of one environment with name, cloud config kind, region and phase. Use for \"Which Confluent Cloud gateways exist in environment env-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment":{"description":"Environment id (starts with env-), for example 'env-abc123'.","maxLength":200,"title":"Environment","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100, default 100).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"required":["environment"],"title":"list_gatewaysArguments","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_ip_addresses":{"post":{"operationId":"list_ip_addresses","summary":"List the public IP address ranges Confluent Cloud uses, filterable by cloud, region, service and address type (useful fo","description":"List the public IP address ranges Confluent Cloud uses, filterable by cloud, region, service and address type (useful for firewall allow lists). Use for \"Which IP ranges does Confluent Cloud use on AWS in us-east-1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cloud":{"anyOf":[{"enum":["AWS","GCP","AZURE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only ranges of this cloud.","title":"Cloud"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only ranges in this region, for example us-east-1.","title":"Region"},"services":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only ranges used by this service, for example KAFKA, CONNECT or EXTERNAL_OAUTH.","title":"Services"},"address_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only ranges of this type, for example EGRESS or INGRESS.","title":"Address Type"},"page_size":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 500).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Opaque token from metadata.next of the previous answer, to get the next page.","title":"Page Token"}},"title":"list_ip_addressesArguments","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}}}}