{"openapi":"3.1.0","info":{"title":"ConfigCat (BYOK) API","version":"0.1.0","description":"ConfigCat (BYOK) lets an AI assistant read your own ConfigCat data through the ConfigCat API with a key you supply (Public API basic auth username). Read-only: 10 tools (get_me, list_organizations, list_products, list_configs, list_environments, list_flags, get_flag_value, list_segments, list_tags, list_audit_logs). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-configcat.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-configcat/docs"},"termsOfService":"https://connectorbay.com/byok-configcat/terms"},"servers":[{"url":"https://byok-configcat.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-configcat/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/get_me":{"post":{"operationId":"get_me","summary":"Show the ConfigCat user the credentials belong to: id, email and full name. Use for \"Which ConfigCat account am I connec","description":"Show the ConfigCat user the credentials belong to: id, email and full name. Use for \"Which ConfigCat account am I connected as\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","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_organizations":{"post":{"operationId":"list_organizations","summary":"List the ConfigCat organizations the user belongs to with their ids. Use for \"Which ConfigCat organizations do I belong ","description":"List the ConfigCat organizations the user belongs to with their ids. Use for \"Which ConfigCat organizations do I belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_organizationsArguments","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_products":{"post":{"operationId":"list_products","summary":"List the ConfigCat products (projects) the user can access with organization, description and whether changes need a rea","description":"List the ConfigCat products (projects) the user can access with organization, description and whether changes need a reason or approval. Use for \"What ConfigCat products do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_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/list_configs":{"post":{"operationId":"list_configs","summary":"List the configs (flag containers) of a product with id, name, description and evaluation version. Use for \"Which config","description":"List the configs (flag containers) of a product with id, name, description and evaluation version. Use for \"Which configs are in my ConfigCat product\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Product id (a UUID) from list_products.","maxLength":40,"title":"Product Id","type":"string"}},"required":["product_id"],"title":"list_configsArguments","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_environments":{"post":{"operationId":"list_environments","summary":"List the environments of a product (for example Production, Test) with id, name and approval settings. Use for \"Which en","description":"List the environments of a product (for example Production, Test) with id, name and approval settings. Use for \"Which environments does my ConfigCat product have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Product id (a UUID) from list_products.","maxLength":40,"title":"Product Id","type":"string"}},"required":["product_id"],"title":"list_environmentsArguments","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_flags":{"post":{"operationId":"list_flags","summary":"List the feature flags and settings of a config with key, name, type, hint and creation time (tags are not returned). Us","description":"List the feature flags and settings of a config with key, name, type, hint and creation time (tags are not returned). Use for \"What feature flags are in my ConfigCat config\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"config_id":{"description":"Config id (a UUID) from list_configs.","maxLength":40,"title":"Config Id","type":"string"}},"required":["config_id"],"title":"list_flagsArguments","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_flag_value":{"post":{"operationId":"get_flag_value","summary":"Get the default value of one flag in one environment (boolean, text, whole or decimal number). Targeting rules are not r","description":"Get the default value of one flag in one environment (boolean, text, whole or decimal number). Targeting rules are not returned. Use for \"What is the default value of ConfigCat flag 12345 in my production environment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"environment_id":{"description":"Environment id (a UUID) from list_environments.","maxLength":40,"title":"Environment Id","type":"string"},"setting_id":{"description":"Numeric flag (setting) id from list_flags.","maximum":1000000000000,"minimum":1,"title":"Setting Id","type":"integer"}},"required":["environment_id","setting_id"],"title":"get_flag_valueArguments","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_segments":{"post":{"operationId":"list_segments","summary":"List the user segments of a product with description, creator, last update and how many flags use each. Use for \"Which s","description":"List the user segments of a product with description, creator, last update and how many flags use each. Use for \"Which segments exist in my ConfigCat product\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Product id (a UUID) from list_products.","maxLength":40,"title":"Product Id","type":"string"}},"required":["product_id"],"title":"list_segmentsArguments","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_tags":{"post":{"operationId":"list_tags","summary":"List the tags of a product with id, name and color. Use for \"Which tags are defined in my ConfigCat product\".","description":"List the tags of a product with id, name and color. Use for \"Which tags are defined in my ConfigCat product\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Product id (a UUID) from list_products.","maxLength":40,"title":"Product Id","type":"string"}},"required":["product_id"],"title":"list_tagsArguments","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_audit_logs":{"post":{"operationId":"list_audit_logs","summary":"List audit log entries of a product, newest first, with who did what and when. Optional date range; up to 100 per page. ","description":"List audit log entries of a product, newest first, with who did what and when. Optional date range; up to 100 per page. Use for \"Who changed feature flags in ConfigCat this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Product id (a UUID) from list_products.","maxLength":40,"title":"Product Id","type":"string"},"from_utc":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only entries from this UTC date-time, for example 2026-10-01T00:00:00Z.","title":"From Utc"},"to_utc":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only entries until this UTC date-time.","title":"To Utc"},"config_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only entries of this config id.","title":"Config Id"},"environment_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only entries of this environment id.","title":"Environment Id"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Entries per page (1 to 100, default 100).","title":"Page Size"},"page_number":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Number"}},"required":["product_id"],"title":"list_audit_logsArguments","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}}}}