## Update device settings for a Zero Trust account `zero_trust.devices.settings.update(SettingUpdateParams**kwargs) -> DeviceSettings` **put** `/accounts/{account_id}/devices/settings` Updates the current device settings for a Zero Trust account. ### Parameters - `account_id: str` - `disable_for_time: Optional[float]` Sets the time limit, in seconds, that a user can use an override code to bypass WARP. - `external_emergency_signal_enabled: Optional[bool]` Controls whether the external emergency disconnect feature is enabled. - `external_emergency_signal_fingerprint: Optional[str]` The SHA256 fingerprint (64 hexadecimal characters) of the HTTPS server certificate for the external_emergency_signal_url. If provided, the WARP client will use this value to verify the server's identity. The device will ignore any response if the server's certificate fingerprint does not exactly match this value. - `external_emergency_signal_interval: Optional[str]` The interval at which the WARP client fetches the emergency disconnect signal, formatted as a duration string (e.g., "5m", "2m30s", "1h"). Minimum 30 seconds. - `external_emergency_signal_url: Optional[str]` The HTTPS URL from which to fetch the emergency disconnect signal. Must use HTTPS and have an IPv4 or IPv6 address as the host. - `gateway_proxy_enabled: Optional[bool]` Enable gateway proxy filtering on TCP. - `gateway_udp_proxy_enabled: Optional[bool]` Enable gateway proxy filtering on UDP. - `root_certificate_installation_enabled: Optional[bool]` Enable installation of cloudflare managed root certificate. - `use_zt_virtual_ip: Optional[bool]` Enable using CGNAT virtual IPv4. ### Returns - `class DeviceSettings: …` - `disable_for_time: Optional[float]` Sets the time limit, in seconds, that a user can use an override code to bypass WARP. - `external_emergency_signal_enabled: Optional[bool]` Controls whether the external emergency disconnect feature is enabled. - `external_emergency_signal_fingerprint: Optional[str]` The SHA256 fingerprint (64 hexadecimal characters) of the HTTPS server certificate for the external_emergency_signal_url. If provided, the WARP client will use this value to verify the server's identity. The device will ignore any response if the server's certificate fingerprint does not exactly match this value. - `external_emergency_signal_interval: Optional[str]` The interval at which the WARP client fetches the emergency disconnect signal, formatted as a duration string (e.g., "5m", "2m30s", "1h"). Minimum 30 seconds. - `external_emergency_signal_url: Optional[str]` The HTTPS URL from which to fetch the emergency disconnect signal. Must use HTTPS and have an IPv4 or IPv6 address as the host. - `gateway_proxy_enabled: Optional[bool]` Enable gateway proxy filtering on TCP. - `gateway_udp_proxy_enabled: Optional[bool]` Enable gateway proxy filtering on UDP. - `root_certificate_installation_enabled: Optional[bool]` Enable installation of cloudflare managed root certificate. - `use_zt_virtual_ip: Optional[bool]` Enable using CGNAT virtual IPv4. ### 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 ) device_settings = client.zero_trust.devices.settings.update( account_id="699d98642c564d2e855e9661899b7252", ) print(device_settings.disable_for_time) ``` #### 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" } } ], "result": { "disable_for_time": 0, "external_emergency_signal_enabled": true, "external_emergency_signal_fingerprint": "abcd1234567890abcd1234567890abcd1234567890abcd1234567890abcd1234", "external_emergency_signal_interval": "5m", "external_emergency_signal_url": "https://192.0.2.1/signal", "gateway_proxy_enabled": true, "gateway_udp_proxy_enabled": true, "root_certificate_installation_enabled": true, "use_zt_virtual_ip": true }, "success": true } ```