Modify Device

put

https://api.controld.com/devices/{device_id}

Modify an existing Endpoint and its settings.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

device_id

string

required

Device/Resolver ID

Form Data

name

string

New Device name

client_count

string

Number of devices using this Endpoint

profile_id

string

Primary key of main profile to enforce on this device

profile_id2

string

Primary key of a second profile to enforce -1 to remove.

stats

integer

Set analytics level on device. 0 = off, 1 = basic, 2 = full

legacy_ipv4_status

integer

Set this to 1 to generate a legacy IPv4 (and IPv6) DNS resolver, 0 to remove existing one.

learn_ip

integer

Enable or disable automatic IP learning and logging. 0 to disable, 1 to enable.

restricted

integer

Make this device restricted. 0 to disable, 1 to enable.

bump_tls

integer

Enable or disable experimental ECH support and TLS bumping

desc

string

Add a description or comment to the device

ddns_status

integer

Status of public DDNS endpoint. 1 = enabled, 0 = disable.

ddns_subdomain

string

DDNS subdomain to expose the IP on

ddns_ext_host

string

DDNS hostname to query to learn new IPs

ddns_ext_status

integer

Status of DDNS based IP learning. 0 to disable, 1 to enable.

status

integer

Update device status. 0 - pending, 1 - active, 2 - soft disabled, 3 - hard disabled

ctrld_custom_config

string

ctrld .toml config file to deploy

Response

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200