{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Creates a Turnstile widget for an account.","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/turnstile_identifier"}},"required":["account_id"],"additionalProperties":false},"query":{"type":"object","properties":{"page":{"description":"Page number of paginated results.","type":"number","default":1,"minimum":1},"per_page":{"description":"Number of items per page.","type":"number","default":25,"maximum":1000,"minimum":5},"order":{"description":"Field to order widgets by.","type":"string","enum":["id","sitekey","name","created_on","modified_on"],"examples":["id"]},"direction":{"description":"Direction to order widgets.","type":"string","enum":["asc","desc"],"examples":["asc"]},"filter":{"type":"string","examples":["name:my-widget"],"description":"Filter widgets by field. The `name` field uses case-insensitive\nsubstring matching; `sitekey` uses exact matching.\nFormat: `field:value`\n\nSupported fields:\n- `name` - Filter by widget name (e.g., `filter=name:login-form`)\n- `sitekey` - Filter by sitekey (e.g., `filter=sitekey:0x4AAA`)\n\nReturns 400 Bad Request if the field is unsupported or format is invalid.\nAn empty filter value returns all results.\n"}},"required":[],"additionalProperties":false},"body":{"type":"object","properties":{"bot_fight_mode":{"$ref":"#/definitions/turnstile_bot_fight_mode"},"clearance_level":{"$ref":"#/definitions/turnstile_clearance_level"},"domains":{"$ref":"#/definitions/turnstile_domains"},"ephemeral_id":{"$ref":"#/definitions/turnstile_ephemeral_id"},"mode":{"allOf":[{"$ref":"#/definitions/turnstile_widget_mode"}]},"name":{"$ref":"#/definitions/turnstile_name"},"offlabel":{"$ref":"#/definitions/turnstile_offlabel"},"region":{"$ref":"#/definitions/turnstile_region"}},"required":["name","mode","domains"]}},"required":["path","body"],"additionalProperties":false,"definitions":{"turnstile_identifier":{"description":"Identifier","type":"string","maxLength":32,"examples":["023e105f4ecef8ad9ca31a8372d0c353"]},"turnstile_bot_fight_mode":{"description":"If bot_fight_mode is set to `true`, Cloudflare issues computationally\nexpensive challenges in response to malicious bots (ENT only).\n","type":"boolean","examples":[false]},"turnstile_clearance_level":{"description":"If Turnstile is embedded on a Cloudflare site and the widget should grant challenge clearance,\nthis setting can determine the clearance level to be set\n","type":"string","enum":["no_clearance","jschallenge","managed","interactive"],"examples":["interactive"]},"turnstile_domains":{"type":"array","items":{"description":"Hosts as a hostname or IPv4/IPv6 address represented by strings. The\nwidget will only work on these domains, and their subdomains.\n","type":"string","examples":["203.0.113.1"]},"maxLength":10,"examples":[["203.0.113.1","cloudflare.com","blog.example.com"]]},"turnstile_ephemeral_id":{"description":"Return the Ephemeral ID in /siteverify (ENT only).\n","type":"boolean","examples":[false]},"turnstile_widget_mode":{"description":"Widget Mode","type":"string","enum":["non-interactive","invisible","managed"],"examples":["invisible"]},"turnstile_name":{"description":"Human readable widget name. Not unique. Cloudflare suggests that you\nset this to a meaningful string to make it easier to identify your\nwidget, and where it is used.\n","type":"string","maxLength":254,"minLength":1,"examples":["blog.cloudflare.com login form"]},"turnstile_offlabel":{"description":"Do not show any Cloudflare branding on the widget (ENT only).\n","type":"boolean","examples":[false]},"turnstile_region":{"description":"Region where this widget can be used. This cannot be changed after creation.\n","type":"string","default":"world","enum":["world","china"]}}},"name":"Create a Turnstile Widget","id":"cloudflare.accounts-turnstile-widget-create","example":{"path":{"account_id":"023e105f4ecef8ad9ca31a8372d0c353"},"body":{"name":"blog.cloudflare.com login form","mode":"invisible","domains":["203.0.113.1","cloudflare.com","blog.example.com"]}},"maxRequests":1,"summary":false}}