--- title: Devices --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Zero Trust](https://developers.cloudflare.com/api/go/resources/zero_trust) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Devices ##### [List devices (deprecated)](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/methods/list) Deprecated client.ZeroTrust.Devices.List(ctx, query) (\*SinglePage\[[Device]()], error) GET/accounts/{account\_id}/devices ##### [Get device (deprecated)](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/methods/get) Deprecated client.ZeroTrust.Devices.Get(ctx, deviceID, query) (\*[DeviceGetResponse](), error) GET/accounts/{account\_id}/devices/{device\_id} ##### ModelsExpand Collapse

type Device struct{…}

ID stringOptional Registration ID. Equal to Device ID except for accounts which enabled multi-user mode. maxLength36 Link to this property Created TimeOptional When the device was created. formatdate-time Link to this property Deleted boolOptional True if the device was deleted. Link to this property

DeviceType DeviceDeviceTypeOptional

One of the following: const DeviceDeviceTypeWindows DeviceDeviceType = "windows" Link to this property const DeviceDeviceTypeMac DeviceDeviceType = "mac" Link to this property const DeviceDeviceTypeLinux DeviceDeviceType = "linux" Link to this property const DeviceDeviceTypeAndroid DeviceDeviceType = "android" Link to this property const DeviceDeviceTypeIos DeviceDeviceType = "ios" Link to this property const DeviceDeviceTypeChromeos DeviceDeviceType = "chromeos" Link to this property

Link to this property IP stringOptional IPv4 or IPv6 address. Link to this property Key stringOptional The device’s public key. Link to this property LastSeen TimeOptional When the device last connected to Cloudflare services. formatdate-time Link to this property MacAddress stringOptional The device mac address. Link to this property Manufacturer stringOptional The device manufacturer name. Link to this property Model stringOptional The device model name. Link to this property Name stringOptional The device name. Link to this property OSDistroName stringOptional The Linux distro name. Link to this property OSDistroRevision stringOptional The Linux distro revision. Link to this property OSVersion stringOptional The operating system version. Link to this property OSVersionExtra stringOptional Additional operating system version details. For Windows, the UBR (Update Build Revision). For Mac or iOS, the Product Version Extra. For Linux, the distribution name and version. Link to this property RevokedAt TimeOptional When the device was revoked. formatdate-time Link to this property SerialNumber stringOptional The device serial number. Link to this property Updated TimeOptional When the device was updated. formatdate-time Link to this property

User DeviceUserOptional

ID stringOptional UUID. maxLength36 Link to this property Email stringOptional The contact email address of the user. maxLength90 Link to this property Name stringOptional The enrolled device user’s name. Link to this property

Link to this property Version stringOptional The WARP client version. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices%20%3E%20(model)%20device%20%3E%20(schema)>) #### DevicesDevices ##### [List devices](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/devices/methods/list) client.ZeroTrust.Devices.Devices.List(ctx, params) (\*CursorPagination\[[DeviceDeviceListResponse]()], error) GET/accounts/{account\_id}/devices/physical-devices ##### [Get device](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/devices/methods/get) client.ZeroTrust.Devices.Devices.Get(ctx, deviceID, params) (\*[DeviceDeviceGetResponse](), error) GET/accounts/{account\_id}/devices/physical-devices/{device\_id} ##### [Delete device](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/devices/methods/delete) client.ZeroTrust.Devices.Devices.Delete(ctx, deviceID, body) (\*[DeviceDeviceDeleteResponse](), error) DELETE/accounts/{account\_id}/devices/physical-devices/{device\_id} ##### [Revoke device registrations](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/devices/methods/revoke) Deprecated client.ZeroTrust.Devices.Devices.Revoke(ctx, deviceID, body) (\*[DeviceDeviceRevokeResponse](), error) POST/accounts/{account\_id}/devices/physical-devices/{device\_id}/revoke #### DevicesResilience #### DevicesResilienceGlobal WARP Override ##### [Get Global Disconnect](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/resilience/subresources/global_warp_override/methods/get) client.ZeroTrust.Devices.Resilience.GlobalWARPOverride.Get(ctx, query) (\*[DeviceResilienceGlobalWARPOverrideGetResponse](), error) GET/accounts/{account\_id}/devices/resilience/disconnect ##### [Set Global Disconnect](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/resilience/subresources/global_warp_override/methods/create) client.ZeroTrust.Devices.Resilience.GlobalWARPOverride.New(ctx, params) (\*[DeviceResilienceGlobalWARPOverrideNewResponse](), error) POST/accounts/{account\_id}/devices/resilience/disconnect #### DevicesRegistrations ##### [List registrations](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/list) client.ZeroTrust.Devices.Registrations.List(ctx, params) (\*CursorPagination\[[DeviceRegistrationListResponse]()], error) GET/accounts/{account\_id}/devices/registrations ##### [Get registration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/get) client.ZeroTrust.Devices.Registrations.Get(ctx, registrationID, params) (\*[DeviceRegistrationGetResponse](), error) GET/accounts/{account\_id}/devices/registrations/{registration\_id} ##### [Delete registration](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/delete) client.ZeroTrust.Devices.Registrations.Delete(ctx, registrationID, body) (\*[DeviceRegistrationDeleteResponse](), error) DELETE/accounts/{account\_id}/devices/registrations/{registration\_id} ##### [Delete registrations](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/bulk_delete) client.ZeroTrust.Devices.Registrations.BulkDelete(ctx, params) (\*[DeviceRegistrationBulkDeleteResponse](), error) DELETE/accounts/{account\_id}/devices/registrations ##### [Revoke registrations](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/revoke) Deprecated client.ZeroTrust.Devices.Registrations.Revoke(ctx, params) (\*[DeviceRegistrationRevokeResponse](), error) POST/accounts/{account\_id}/devices/registrations/revoke ##### [Unrevoke registrations](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/registrations/methods/unrevoke) Deprecated client.ZeroTrust.Devices.Registrations.Unrevoke(ctx, params) (\*[DeviceRegistrationUnrevokeResponse](), error) POST/accounts/{account\_id}/devices/registrations/unrevoke #### DevicesDEX Tests ##### [List Device DEX tests](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/dex_tests/methods/list) client.ZeroTrust.Devices.DEXTests.List(ctx, params) (\*V4PagePaginationArray\[[SchemaHTTP]()], error) GET/accounts/{account\_id}/dex/devices/dex\_tests ##### [Get Device DEX test](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/dex_tests/methods/get) client.ZeroTrust.Devices.DEXTests.Get(ctx, dexTestID, query) (\*[SchemaHTTP](), error) GET/accounts/{account\_id}/dex/devices/dex\_tests/{dex\_test\_id} ##### [Create Device DEX test](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/dex_tests/methods/create) client.ZeroTrust.Devices.DEXTests.New(ctx, params) (\*[SchemaHTTP](), error) POST/accounts/{account\_id}/dex/devices/dex\_tests ##### [Update Device DEX test](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/dex_tests/methods/update) client.ZeroTrust.Devices.DEXTests.Update(ctx, dexTestID, params) (\*[SchemaHTTP](), error) PUT/accounts/{account\_id}/dex/devices/dex\_tests/{dex\_test\_id} ##### [Delete Device DEX test](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/dex_tests/methods/delete) client.ZeroTrust.Devices.DEXTests.Delete(ctx, dexTestID, body) (\*[DeviceDEXTestDeleteResponse](), error) DELETE/accounts/{account\_id}/dex/devices/dex\_tests/{dex\_test\_id} ##### ModelsExpand Collapse

type SchemaData struct{…} The configuration object which contains the details for the WARP client to conduct the test.

Host string The desired endpoint to test. Link to this property

Kind SchemaDataKind The type of test.

One of the following: const SchemaDataKindHTTP SchemaDataKind = "http" Link to this property const SchemaDataKindTraceroute SchemaDataKind = "traceroute" Link to this property

Link to this property Method SchemaDataMethodOptional The HTTP request method type. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(model)%20schema_data%20%3E%20(schema)>)

type SchemaHTTP struct{…}

Data SchemaData The configuration object which contains the details for the WARP client to conduct the test. Link to this property Enabled bool Determines whether or not the test is active. Link to this property Interval string How often the test will run. Link to this property Name string The name of the DEX test. Must be unique. Link to this property Created TimeOptional Date the test was created, in RFC 3339 format. formatdate-time Link to this property Description stringOptional Additional details about the test. Link to this property

TargetPolicies \[]SchemaHTTPTargetPolicyOptional DEX rules targeted by this test

ID string The id of the DEX rule. maxLength36 Link to this property Default boolOptional Whether the DEX rule is the account default. Link to this property Name stringOptional The name of the DEX rule. Link to this property

Link to this property Targeted boolOptional Link to this property TestID stringOptional The unique identifier for the test. maxLength32 Link to this property Updated TimeOptional Date the test was last updated, in RFC 3339 format. formatdate-time Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(model)%20schema_http%20%3E%20(schema)>) #### DevicesIP Profiles ##### [List IP profiles](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/ip_profiles/methods/list) client.ZeroTrust.Devices.IPProfiles.List(ctx, params) (\*V4PagePaginationArray\[[IPProfile]()], error) GET/accounts/{account\_id}/devices/ip-profiles ##### [Get IP profile](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/ip_profiles/methods/get) client.ZeroTrust.Devices.IPProfiles.Get(ctx, profileID, query) (\*[IPProfile](), error) GET/accounts/{account\_id}/devices/ip-profiles/{profile\_id} ##### [Create IP profile](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/ip_profiles/methods/create) client.ZeroTrust.Devices.IPProfiles.New(ctx, params) (\*[IPProfile](), error) POST/accounts/{account\_id}/devices/ip-profiles ##### [Update IP profile](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/ip_profiles/methods/update) client.ZeroTrust.Devices.IPProfiles.Update(ctx, profileID, params) (\*[IPProfile](), error) PATCH/accounts/{account\_id}/devices/ip-profiles/{profile\_id} ##### [Delete IP profile](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/ip_profiles/methods/delete) client.ZeroTrust.Devices.IPProfiles.Delete(ctx, profileID, body) (\*[DeviceIPProfileDeleteResponse](), error) DELETE/accounts/{account\_id}/devices/ip-profiles/{profile\_id} ##### ModelsExpand Collapse

type IPProfile struct{…}

ID string The ID of the Device IP profile. Link to this property CreatedAt string The RFC3339Nano timestamp when the Device IP profile was created. Link to this property Description string An optional description of the Device IP profile. Link to this property Enabled bool Whether the Device IP profile is enabled. Link to this property Match string The wirefilter expression to match registrations. Available values: “identity.name”, “identity.email”, “identity.groups.id”, “identity.groups.name”, “identity.groups.email”, “identity.saml\_attributes”. maxLength10000 Link to this property Name string A user-friendly name for the Device IP profile. Link to this property Precedence int64 The precedence of the Device IP profile. Lower values indicate higher precedence. Device IP profile will be evaluated in ascending order of this field. Link to this property SubnetID string The ID of the Subnet. Link to this property UpdatedAt string The RFC3339Nano timestamp when the Device IP profile was last updated. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.ip_profiles%20%3E%20(model)%20ip_profile%20%3E%20(schema)>) #### DevicesDeployment Groups ##### [List deployment groups](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/deployment_groups/methods/list) client.ZeroTrust.Devices.DeploymentGroups.List(ctx, params) (\*V4PagePaginationArray\[[DeploymentGroup]()], error) GET/accounts/{account\_id}/devices/deployment-groups ##### [Get deployment group](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/deployment_groups/methods/get) client.ZeroTrust.Devices.DeploymentGroups.Get(ctx, groupID, query) (\*[DeploymentGroup](), error) GET/accounts/{account\_id}/devices/deployment-groups/{group\_id} ##### [Create deployment group](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/deployment_groups/methods/create) client.ZeroTrust.Devices.DeploymentGroups.New(ctx, params) (\*[DeploymentGroup](), error) POST/accounts/{account\_id}/devices/deployment-groups ##### [Update deployment group](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/deployment_groups/methods/edit) client.ZeroTrust.Devices.DeploymentGroups.Edit(ctx, groupID, params) (\*[DeploymentGroup](), error) PATCH/accounts/{account\_id}/devices/deployment-groups/{group\_id} ##### [Delete deployment group](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/deployment_groups/methods/delete) client.ZeroTrust.Devices.DeploymentGroups.Delete(ctx, groupID, body) (\*[DeviceDeploymentGroupDeleteResponse](), error) DELETE/accounts/{account\_id}/devices/deployment-groups/{group\_id} ##### ModelsExpand Collapse

type DeploymentGroup struct{…}

ID string The ID of the deployment group. Link to this property CreatedAt string The RFC3339Nano timestamp when the deployment group was created. Link to this property Name string A user-friendly name for the deployment group. maxLength255 minLength1 Link to this property UpdatedAt string The RFC3339Nano timestamp when the deployment group was last updated. Link to this property

VersionConfig \[]DeploymentGroupVersionConfig Contains version configurations for different target environments.

TargetEnvironment string The target environment for the client version (e.g., windows, macos). Link to this property Version string The specific client version to deploy. Link to this property

Link to this property PolicyIDs \[]stringOptional Contains a list of policy IDs assigned to this deployment group. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.deployment_groups%20%3E%20(model)%20deployment_group%20%3E%20(schema)>) #### DevicesNetworks ##### [List your device managed networks](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/networks/methods/list) client.ZeroTrust.Devices.Networks.List(ctx, query) (\*SinglePage\[[DeviceNetwork]()], error) GET/accounts/{account\_id}/devices/networks ##### [Get device managed network details](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/networks/methods/get) client.ZeroTrust.Devices.Networks.Get(ctx, networkID, query) (\*[DeviceNetwork](), error) GET/accounts/{account\_id}/devices/networks/{network\_id} ##### [Create a device managed network](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/networks/methods/create) client.ZeroTrust.Devices.Networks.New(ctx, params) (\*[DeviceNetwork](), error) POST/accounts/{account\_id}/devices/networks ##### [Update a device managed network](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/networks/methods/update) client.ZeroTrust.Devices.Networks.Update(ctx, networkID, params) (\*[DeviceNetwork](), error) PUT/accounts/{account\_id}/devices/networks/{network\_id} ##### [Delete a device managed network](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/networks/methods/delete) client.ZeroTrust.Devices.Networks.Delete(ctx, networkID, body) (\*SinglePage\[[DeviceNetwork]()], error) DELETE/accounts/{account\_id}/devices/networks/{network\_id} ##### ModelsExpand Collapse

type DeviceNetwork struct{…}

Config DeviceNetworkConfigOptional The configuration object containing information for the WARP client to detect the managed network.

TLSSockaddr string A network address of the form “host:port” that the WARP client will use to detect the presence of a TLS host. Link to this property Sha256 stringOptional The SHA-256 hash of the TLS certificate presented by the host found at tls\_sockaddr. If absent, regular certificate verification (trusted roots, valid timestamp, etc) will be used to validate the certificate. Link to this property

Link to this property Name stringOptional The name of the device managed network. This name must be unique. Link to this property NetworkID stringOptional API UUID. maxLength36 Link to this property Type DeviceNetworkTypeOptional The type of device managed network. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.networks%20%3E%20(model)%20device_network%20%3E%20(schema)>) #### DevicesFleet Status ##### [Get the latest status of a device.](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices/subresources/fleet_status/methods/get) client.ZeroTrust.Devices.FleetStatus.Get(ctx, deviceID, params) (\*[DeviceFleetStatusGetResponse](), error) GET/accounts/{account\_id}/dex/devices/{device\_id}/fleet-status/live #### DevicesPolicies ##### ModelsExpand Collapse

type DevicePolicyCertificates struct{…}

Enabled bool The current status of the device policy certificate provisioning feature for WARP clients. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.policies%20%3E%20(model)%20device_policy_certificates%20%3E%20(schema)>)

type FallbackDomain struct{…}

Suffix string The domain suffix to match when resolving locally. Link to this property Description stringOptional A description of the fallback domain, displayed in the client UI. maxLength100 Link to this property DNSServer \[]stringOptional A list of IP addresses to handle domain resolution. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.policies%20%3E%20(model)%20fallback_domain%20%3E%20(schema)>)

type SettingsPolicy struct{…}

AllowModeSwitch boolOptional Whether to allow the user to switch WARP between modes. Link to this property AllowUpdates boolOptional Whether to receive update notifications when a new version of the client is available. Link to this property AllowedToLeave boolOptional Whether to allow devices to leave the organization. Link to this property AutoConnect float64Optional The amount of time in seconds to reconnect after having been disabled. Link to this property

BrowserExtensionConfig SettingsPolicyBrowserExtensionConfigOptional Browser extension proxy settings. Required when profile\_type is browser\_extension and invalid for WARP profiles.

ProxyControl SettingsPolicyBrowserExtensionConfigProxyControl Whether the user may disable the browser extension proxy.

One of the following: const SettingsPolicyBrowserExtensionConfigProxyControlUnlocked SettingsPolicyBrowserExtensionConfigProxyControl = "unlocked" Link to this property const SettingsPolicyBrowserExtensionConfigProxyControlLocked SettingsPolicyBrowserExtensionConfigProxyControl = "locked" Link to this property

Link to this property ProxyEnabled bool Whether the browser extension proxy is active. Link to this property

Link to this property CaptivePortal float64Optional Turn on the captive portal after the specified amount of time. Link to this property Default boolOptional Whether the policy is the account default. WARP group profiles cannot set this field. Link to this property Description stringOptional A description of the policy. maxLength500 Link to this property DisableAutoFallback boolOptional If the dns_server field of a fallback domain is not present, the client will fall back to a best guess of the default/system DNS resolvers unless this policy option is set to true. Link to this property

DNSSearchSuffixes \[]SettingsPolicyDNSSearchSuffixOptional List of DNS search suffixes to apply to clients. Suffixes are evaluated in order. Use an empty array to clear.

Suffix string The DNS search suffix to append when resolving short hostnames. Link to this property Description stringOptional A description of the DNS search suffix. Link to this property

Link to this property Enabled boolOptional Whether the policy will be applied to matching devices. Link to this property

Exclude \[]SplitTunnelExcludeOptional List of routes excluded in the WARP client’s tunnel.

One of the following:

type SplitTunnelExcludeTeamsDevicesExcludeSplitTunnelWithAddress struct{…}

Address string The address in CIDR format to exclude from the tunnel. If address is present, host must not be present. Link to this property Description stringOptional A description of the Split Tunnel item, displayed in the client UI. maxLength100 Link to this property