## Delete a Turnstile Widget `turnstile.widgets.delete(strsitekey, WidgetDeleteParams**kwargs) -> Widget` **delete** `/accounts/{account_id}/challenges/widgets/{sitekey}` Destroy a Turnstile Widget. ### Parameters - `account_id: str` Identifier - `sitekey: str` Widget item identifier tag. ### Returns - `class Widget: …` A Turnstile widget's detailed configuration - `bot_fight_mode: bool` If bot_fight_mode is set to `true`, Cloudflare issues computationally expensive challenges in response to malicious bots (ENT only). - `clearance_level: Literal["no_clearance", "jschallenge", "managed", "interactive"]` If Turnstile is embedded on a Cloudflare site and the widget should grant challenge clearance, this setting can determine the clearance level to be set - `"no_clearance"` - `"jschallenge"` - `"managed"` - `"interactive"` - `created_on: datetime` When the widget was created. - `domains: List[WidgetDomain]` - `ephemeral_id: bool` Return the Ephemeral ID in /siteverify (ENT only). - `mode: Literal["non-interactive", "invisible", "managed"]` Widget Mode - `"non-interactive"` - `"invisible"` - `"managed"` - `modified_on: datetime` When the widget was modified. - `name: str` Human readable widget name. Not unique. Cloudflare suggests that you set this to a meaningful string to make it easier to identify your widget, and where it is used. - `offlabel: bool` Do not show any Cloudflare branding on the widget (ENT only). - `region: Literal["world", "china"]` Region where this widget can be used. This cannot be changed after creation. - `"world"` - `"china"` - `secret: str` Secret key for this widget. - `sitekey: str` Widget item identifier tag. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) widget = client.turnstile.widgets.delete( sitekey="0x4AAF00AAAABn0R22HWm-YUc", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(widget.ephemeral_id) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "bot_fight_mode": false, "clearance_level": "interactive", "created_on": "2014-01-01T05:20:00.123123Z", "domains": [ "203.0.113.1", "cloudflare.com", "blog.example.com" ], "ephemeral_id": false, "mode": "invisible", "modified_on": "2014-01-01T05:20:00.123123Z", "name": "blog.cloudflare.com login form", "offlabel": false, "region": "world", "secret": "0x4AAF00AAAABn0R22HWm098HVBjhdsYUc", "sitekey": "0x4AAF00AAAABn0R22HWm-YUc" } } ```