{"openapi":"3.1.0","info":{"title":"Kong Konnect API Builder (BYOK) API","version":"0.1.0","description":"Kong Konnect API Builder (BYOK) lets an AI assistant read your own Kong Konnect API Builder data through the Kong Konnect API Builder API with a key you supply (Konnect personal or system account access token). Read-only: 12 tools (list_apis, get_api, list_api_versions, list_api_specs, list_api_documents, list_api_operations, list_api_registrations, list_api_publications,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kong-konnect-api-builder.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kong-konnect-api-builder/docs"},"termsOfService":"https://connectorbay.com/byok-kong-konnect-api-builder/terms"},"servers":[{"url":"https://byok-kong-konnect-api-builder.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kong-konnect-api-builder/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_apis":{"post":{"operationId":"list_apis","summary":"List the APIs of the Konnect API catalog with version, slug, portals they are published to, labels and implementation mo","description":"List the APIs of the Konnect API catalog with version, slug, portals they are published to, labels and implementation mode. Use for \"Which APIs are in our Kong API catalog\".","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"},"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_apisArguments","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":{"post":{"operationId":"get_api","summary":"Get one API: description, current version summary, portals, labels and attributes. Use for \"What is the current version ","description":"Get one API: description, current version summary, portals, labels and attributes. Use for \"What is the current version of the Orders API and where is it published\".","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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api Id","type":"string"}},"required":["region","api_id"],"title":"get_apiArguments","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_versions":{"post":{"operationId":"list_api_versions","summary":"List the versions of an API with version string and spec type (spec contents are not returned). Use for \"Which versions ","description":"List the versions of an API with version string and spec type (spec contents are not returned). Use for \"Which versions of the Orders API exist\".","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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api 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_id"],"title":"list_api_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/list_api_specs":{"post":{"operationId":"list_api_specs","summary":"List the specification documents of an API with id and type (spec contents are not returned). Use for \"Which specificati","description":"List the specification documents of an API with id and type (spec contents are not returned). Use for \"Which specifications are attached to the Orders API\".","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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api 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_id"],"title":"list_api_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_documents":{"post":{"operationId":"list_api_documents","summary":"List the documentation pages of an API with title, slug, status and parent page (page content is not returned). Use for ","description":"List the documentation pages of an API with title, slug, status and parent page (page content is not returned). Use for \"What documentation pages does the Orders API 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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api Id","type":"string"}},"required":["region","api_id"],"title":"list_api_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}},"/v1/tools/list_api_operations":{"post":{"operationId":"list_api_operations","summary":"List the operations (method and path) of an API with whether each is matched to a gateway route. Use for \"Which Orders A","description":"List the operations (method and path) of an API with whether each is matched to a gateway route. Use for \"Which Orders API operations are implemented on a Kong gateway\".","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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api 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_id"],"title":"list_api_operationsArguments","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_registrations":{"post":{"operationId":"list_api_registrations","summary":"List application registrations for an API with status, portal and application. Use for \"Which applications registered fo","description":"List application registrations for an API with status, portal and application. Use for \"Which applications registered for the Orders API and what is their status\".","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_id":{"description":"API id (UUID) from list_apis.","maxLength":64,"title":"Api 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_id"],"title":"list_api_registrationsArguments","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_publications":{"post":{"operationId":"list_api_publications","summary":"List all API publications to developer portals with visibility and registration approval settings. Use for \"Which APIs a","description":"List all API publications to developer portals with visibility and registration approval settings. Use for \"Which APIs are published to which developer portals\".","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"},"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_publicationsArguments","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_portal_api_publications":{"post":{"operationId":"list_portal_api_publications","summary":"List the API publications of one developer portal. Use for \"Which APIs are published on portal p1\".","description":"List the API publications of one developer portal. Use for \"Which APIs are published on portal p1\".","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"},"portal_id":{"description":"Developer portal id (UUID) from the Dev Portal listing.","maxLength":64,"title":"Portal 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","portal_id"],"title":"list_portal_api_publicationsArguments","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_attributes":{"post":{"operationId":"list_api_attributes","summary":"List the custom attribute keys defined for APIs with the values in use. Use for \"Which custom attributes do our Kong API","description":"List the custom attribute keys defined for APIs with the values in use. Use for \"Which custom attributes do our Kong APIs use\".","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"},"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_attributesArguments","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_packages":{"post":{"operationId":"list_api_packages","summary":"List API packages (bundles of API operations) with version, slug, rate limit configuration and labels. Use for \"Which AP","description":"List API packages (bundles of API operations) with version, slug, rate limit configuration and labels. Use for \"Which API packages 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"},"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_packagesArguments","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_package_operations":{"post":{"operationId":"list_api_package_operations","summary":"List the operations contained in an API package with their API and rate limit. Use for \"Which operations are in the Part","description":"List the operations contained in an API package with their API and rate limit. Use for \"Which operations are in the Partner bundle API package\".","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"},"package_id":{"description":"API package id (UUID) from list_api_packages.","maxLength":64,"title":"Package 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","package_id"],"title":"list_api_package_operationsArguments","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}}}}