{"openapi":"3.1.0","info":{"title":"Cloudflare Zone Settings (BYOK) API","version":"0.1.0","description":"Cloudflare Zone Settings (BYOK) lets an AI assistant read your own Cloudflare Zone Settings data through the Cloudflare Zone Settings API with a key you supply (Cloudflare API token with Zone Settings read permission). Read-only: 9 tools (list_zone_settings, get_zone_setting, get_tiered_caching, get_smart_tiered_cache, get_regional_tiered_cache, get_cache_reserve, get_argo_smart_routing,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-cloudflare-zone-settings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-cloudflare-zone-settings/docs"},"termsOfService":"https://connectorbay.com/byok-cloudflare-zone-settings/terms"},"servers":[{"url":"https://byok-cloudflare-zone-settings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-cloudflare-zone-settings/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_zone_settings":{"post":{"operationId":"list_zone_settings","summary":"List all settings of a zone with id, current value, editable flag and last modification time (SSL mode, minimum TLS vers","description":"List all settings of a zone with id, current value, editable flag and last modification time (SSL mode, minimum TLS version, always use HTTPS, security level, caching and more). Use for \"What are the security and TLS settings of my Cloudflare zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"list_zone_settingsArguments","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_zone_setting":{"post":{"operationId":"get_zone_setting","summary":"Get one zone setting by name, such as ssl, min_tls_version, always_use_https, security_level, browser_cache_ttl or devel","description":"Get one zone setting by name, such as ssl, min_tls_version, always_use_https, security_level, browser_cache_ttl or development_mode. Use for \"What is the SSL mode of my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"},"setting_id":{"description":"Zone setting name, for example 'ssl', 'min_tls_version', 'always_use_https', 'security_level' or 'browser_cache_ttl' (the ids list_zone_settings returns).","maxLength":64,"title":"Setting Id","type":"string"}},"required":["zone_id","setting_id"],"title":"get_zone_settingArguments","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_tiered_caching":{"post":{"operationId":"get_tiered_caching","summary":"Show whether Tiered Caching is on or off for a zone. Use for \"Is Tiered Caching enabled on my zone\".","description":"Show whether Tiered Caching is on or off for a zone. Use for \"Is Tiered Caching enabled on my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_tiered_cachingArguments","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_smart_tiered_cache":{"post":{"operationId":"get_smart_tiered_cache","summary":"Show whether Smart Tiered Cache topology is on or off for a zone. Use for \"Is Smart Tiered Cache enabled on my zone\".","description":"Show whether Smart Tiered Cache topology is on or off for a zone. Use for \"Is Smart Tiered Cache enabled on my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_smart_tiered_cacheArguments","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_regional_tiered_cache":{"post":{"operationId":"get_regional_tiered_cache","summary":"Show whether Regional Tiered Cache is on or off for a zone. Use for \"Is Regional Tiered Cache enabled on my zone\".","description":"Show whether Regional Tiered Cache is on or off for a zone. Use for \"Is Regional Tiered Cache enabled on my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_regional_tiered_cacheArguments","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_cache_reserve":{"post":{"operationId":"get_cache_reserve","summary":"Show whether Cache Reserve is on or off for a zone. Use for \"Is Cache Reserve enabled on my zone\".","description":"Show whether Cache Reserve is on or off for a zone. Use for \"Is Cache Reserve enabled on my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_cache_reserveArguments","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_argo_smart_routing":{"post":{"operationId":"get_argo_smart_routing","summary":"Show whether Argo Smart Routing is on or off for a zone. Use for \"Is Argo Smart Routing enabled on my zone\".","description":"Show whether Argo Smart Routing is on or off for a zone. Use for \"Is Argo Smart Routing enabled on my zone\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_argo_smart_routingArguments","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_origin_post_quantum_encryption":{"post":{"operationId":"get_origin_post_quantum_encryption","summary":"Show the origin post-quantum encryption mode (preferred, supported or off) of a zone. Use for \"What origin post-quantum ","description":"Show the origin post-quantum encryption mode (preferred, supported or off) of a zone. Use for \"What origin post-quantum mode does my zone use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_origin_post_quantum_encryptionArguments","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_zone_hold":{"post":{"operationId":"get_zone_hold","summary":"Show whether a zone hold is active (blocking others from adding the domain) with the hold-after time and whether subdoma","description":"Show whether a zone hold is active (blocking others from adding the domain) with the hold-after time and whether subdomains are included. Use for \"Is a zone hold active on my domain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Cloudflare zone id (32-character hex string, from the Cloudflare connector's list_zones).","maxLength":40,"title":"Zone Id","type":"string"}},"required":["zone_id"],"title":"get_zone_holdArguments","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}}}}