{"openapi":"3.1.0","info":{"title":"Kong Konnect API Products (BYOK) API","version":"0.1.0","description":"Kong Konnect API Products (BYOK) lets an AI assistant read your own Kong Konnect API Products data through the Kong Konnect API Products API with a key you supply (Konnect personal or system account access token). Read-only: 6 tools (list_api_products, get_api_product, list_api_product_versions, get_api_product_version, list_api_product_version_specs, list_api_product_documents). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kong-konnect-api-products.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kong-konnect-api-products/docs"},"termsOfService":"https://connectorbay.com/byok-kong-konnect-api-products/terms"},"servers":[{"url":"https://byok-kong-konnect-api-products.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kong-konnect-api-products/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_api_products":{"post":{"operationId":"list_api_products","summary":"List the API products of the Konnect organization with description, portals they are published to, version count and lab","description":"List the API products of the Konnect organization with description, portals they are published to, version count and labels. Use for \"Which API products do we have in Kong Konnect\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","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"},"labels":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only products with these labels, for example 'env:prod' (comma-separated key:value pairs).","title":"Labels"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region"],"title":"list_api_productsArguments","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_api_product":{"post":{"operationId":"get_api_product","summary":"Get one API product with the portals it is published in, version count and labels. Use for \"Which portals is the Orders ","description":"Get one API product with the portals it is published in, version count and labels. Use for \"Which portals is the Orders API product published to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"api_product_id":{"description":"API product id (UUID) from list_api_products.","maxLength":64,"title":"Api Product Id","type":"string"}},"required":["region","api_product_id"],"title":"get_api_productArguments","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_api_product_versions":{"post":{"operationId":"list_api_product_versions","summary":"List the versions of an API product with publish status, deprecation flag, linked gateway service and portals. Use for \"","description":"List the versions of an API product with publish status, deprecation flag, linked gateway service and portals. Use for \"What versions does the Orders API product have and which are deprecated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"api_product_id":{"description":"API product id (UUID) from list_api_products.","maxLength":64,"title":"Api Product 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"},"sort":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as 'name' or 'created_at desc'.","title":"Sort"}},"required":["region","api_product_id"],"title":"list_api_product_versionsArguments","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_api_product_version":{"post":{"operationId":"get_api_product_version","summary":"Get one API product version: publish status, gateway service link, portal publications and authentication strategy sync ","description":"Get one API product version: publish status, gateway service link, portal publications and authentication strategy sync errors. Use for \"Is version v1 of the Orders API product published and are there auth sync errors\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"api_product_id":{"description":"API product id (UUID) from list_api_products.","maxLength":64,"title":"Api Product Id","type":"string"},"version_id":{"description":"API product version id (UUID) from list_api_product_versions.","maxLength":64,"title":"Version Id","type":"string"}},"required":["region","api_product_id","version_id"],"title":"get_api_product_versionArguments","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_api_product_version_specs":{"post":{"operationId":"list_api_product_version_specs","summary":"List the specification documents attached to an API product version (id, name, timestamps; the spec text itself is not r","description":"List the specification documents attached to an API product version (id, name, timestamps; the spec text itself is not returned). Use for \"Which OpenAPI specs are attached to version v1 of the Orders API product\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"api_product_id":{"description":"API product id (UUID) from list_api_products.","maxLength":64,"title":"Api Product Id","type":"string"},"version_id":{"description":"API product version id (UUID) from list_api_product_versions.","maxLength":64,"title":"Version Id","type":"string"}},"required":["region","api_product_id","version_id"],"title":"list_api_product_version_specsArguments","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_api_product_documents":{"post":{"operationId":"list_api_product_documents","summary":"List the documentation pages of an API product with title, slug, parent page and publish status (page content is not ret","description":"List the documentation pages of an API product with title, slug, parent page and publish status (page content is not returned). Use for \"Which documentation pages does the Orders API product have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Konnect geography of the organization: us, eu, au, me, in or sg (the host is <region>.api.konghq.com).","enum":["us","eu","au","me","in","sg"],"title":"Region","type":"string"},"api_product_id":{"description":"API product id (UUID) from list_api_products.","maxLength":64,"title":"Api Product 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":["region","api_product_id"],"title":"list_api_product_documentsArguments","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}}}}