Skip to main content
Server path: /control-d | Type: Application | PCID required: Yes

Tools

ToolDescription
control_d_delete_accessDelete Learned IP
control_d_delete_devices_by_device_idDelete Endpoint
control_d_delete_profiles_by_profile_idProfiles - Delete
control_d_delete_profiles_by_profile_id_groups_by_folderRule Folders - Delete
control_d_delete_profiles_by_profile_id_rules_by_hostnameCustom Rules - Delete
control_d_get_accessList Known IPs
control_d_get_analytics_endpointsList Storage Regions
control_d_get_analytics_levelsList Log Levels
control_d_get_billing_paymentsPayments
control_d_get_billing_productsActive Products
control_d_get_billing_subscriptionsSubscriptions
control_d_get_devicesList All Endpoints
control_d_get_devices_typesList Endpoint Types
control_d_get_ipReturn IP
control_d_get_networkNetwork Stats
control_d_get_organizations_membersView Members
control_d_get_organizations_organizationView Organization Info
control_d_get_organizations_sub_organizationsView Sub-Organizations
control_d_get_profilesProfiles - List
control_d_get_profiles_by_profile_id_defaultDefault Rule - List
control_d_get_profiles_by_profile_id_filtersFilters - List Native
control_d_get_profiles_by_profile_id_filters_externalFilters - List 3rd Party
control_d_get_profiles_by_profile_id_groupsRule Folders - LIst
control_d_get_profiles_by_profile_id_rules_by_folder_idCustom Rules - List
control_d_get_profiles_by_profile_id_servicesServices - List
control_d_get_profiles_optionsProfiles - List Options
control_d_get_proxiesList Proxies
control_d_get_services_categoriesList Service Categories
control_d_get_services_categories_by_categoryLIst All Services
control_d_get_usersUser Data
control_d_post_accessLearn New IP
control_d_post_devicesCreate Endpoint
control_d_post_organizations_suborgCreate Sub-Organization
control_d_post_profilesProfiles - Create
control_d_post_profiles_by_profile_id_groupsRule Folders - Create
control_d_post_profiles_by_profile_id_rulesCustom Rules - Create
control_d_put_devices_by_device_idModify Endpoint
control_d_put_organizationsModify Organization
control_d_put_profiles_by_profile_idProfiles - Modify
control_d_put_profiles_by_profile_id_defaultDefault Rule - Modify
control_d_put_profiles_by_profile_id_filtersFilters - Batch Modify
control_d_put_profiles_by_profile_id_filters_filter_by_filterFilters - Modify
control_d_put_profiles_by_profile_id_groups_by_folderRule Folders - Modify
control_d_put_profiles_by_profile_id_options_by_nameProfiles - Modify Options
control_d_put_profiles_by_profile_id_rulesCustom Rules - Modify
control_d_put_profiles_by_profile_id_services_by_serviceServices - Modify

control_d_delete_access

Delete Learned IP Parameters:
ParameterTypeRequiredDefaultDescription
device_idstringNoPrimary key of the device.
ips[]any[]NoIPv4 or IPv6 addresses

control_d_delete_devices_by_device_id

Delete Endpoint Parameters:
ParameterTypeRequiredDefaultDescription
device_idstringYesDevice/Resolver ID

control_d_delete_profiles_by_profile_id

Profiles - Delete Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_delete_profiles_by_profile_id_groups_by_folder

Rule Folders - Delete Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
folderstringYesFolder ID
dostringNo(Optional) Add a rule type to a folder. All rules inside will inherit rule type.
namestringNo(Optional) Rename the folder.
statusstringNoStatus of the folder and all rules inside.
viastringNo(Optional) Add spoof IP or hostname, or proxy identiifer if do=2 or do=3.

control_d_delete_profiles_by_profile_id_rules_by_hostname

Custom Rules - Delete Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
hostnamestringYesHostname to delete

control_d_get_access

List Known IPs Parameters:
ParameterTypeRequiredDefaultDescription
device_idstringYes(Required) Primary key of the device.

control_d_get_analytics_endpoints

List Storage Regions

control_d_get_analytics_levels

List Log Levels

control_d_get_billing_payments

Payments

control_d_get_billing_products

Active Products

control_d_get_billing_subscriptions

Subscriptions

control_d_get_devices

List All Endpoints

control_d_get_devices_types

List Endpoint Types

control_d_get_ip

Return IP

control_d_get_network

Network Stats

control_d_get_organizations_members

View Members

control_d_get_organizations_organization

View Organization Info

control_d_get_organizations_sub_organizations

View Sub-Organizations

control_d_get_profiles

Profiles - List

control_d_get_profiles_by_profile_id_default

Default Rule - List Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_get_profiles_by_profile_id_filters

Filters - List Native Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_get_profiles_by_profile_id_filters_external

Filters - List 3rd Party Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_get_profiles_by_profile_id_groups

Rule Folders - LIst Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_get_profiles_by_profile_id_rules_by_folder_id

Custom Rules - List Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
folder_idstringYesFolder ID (0 or omit for root)

control_d_get_profiles_by_profile_id_services

Services - List Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile

control_d_get_profiles_options

Profiles - List Options

control_d_get_proxies

List Proxies

control_d_get_services_categories

List Service Categories

control_d_get_services_categories_by_category

LIst All Services Parameters:
ParameterTypeRequiredDefaultDescription
categorystringYesCategory name

control_d_get_users

User Data

control_d_post_access

Learn New IP Parameters:
ParameterTypeRequiredDefaultDescription
device_idstringYesPrimary key of the device.
ips[]any[]YesIPv4 or IPv6 addresses

control_d_post_devices

Create Endpoint Parameters:
ParameterTypeRequiredDefaultDescription
client_countstringYesNumber of devices using this Endpoint
ddns_ext_hoststringNoDDNS hostname to query to learn new IPs
ddns_ext_statusintegerNoStatus of DDNS based IP learning
ddns_statusintegerNoStatus of DDNS endpoint that exposes last used IP.
ddns_subdomainstringNoDDNS subdomain to expose the IP on
descstringNoAdd a description or comment to the device
iconstringYesDevice icon/type
learn_ipintegerNoEnable or disable automatic IP learning and logging. 0 to disable, 1 to enable.
legacy_ipv4_statusintegerNoSet this to 1 to generate a legacy IPv4 (and IPv6) DNS resolver.
namestringYesDevice name
profile_idstringYesPrimary key of main profile to enforce on this device
profile_id2stringNoPrimary key of a second profile to enforce
remap_client_idstringNoRemap source device + client ID to a new device
remap_device_idstringNoRemap source device + client ID to a new device
restrictedintegerNoMake this device restricted, only previously authorized IPs will be able to query against it
statsintegerNoSet analytics level on device. 0 = off, 1 = basic, 2 = full

control_d_post_organizations_suborg

Create Sub-Organization Parameters:
ParameterTypeRequiredDefaultDescription
addressstringNo(Optional) Physical address of this organization
contact_emailstringYes(Required) Primary contact for this sub-organization
contact_namestringNo(Optional) Contact name for the person responsible for this organization
contact_phonestringNo(Optional) Phone number associated with this organization
namestringYes(Required) Organization name
parent_profilestringNo(Optional) Global Profile ID (PK) to enforce on all created Devices
stats_endpointstringYes(Required) Primary key of desired storage region. See GET /analytics/endpoints
twofa_reqintegerYes(Required) Is 2FA/MFA required for memberts of this org. 0 = no, 1 = yes
websitestringNo(Optional) Website URL of this organization

control_d_post_profiles

Profiles - Create Parameters:
ParameterTypeRequiredDefaultDescription
clone_profile_idstringNoPrimary key of profile to clone. If ommited, a blank profile is created.
namestringYesName of the new profile

control_d_post_profiles_by_profile_id_groups

Rule Folders - Create Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
dointegerYesAdd a rule type to a folder. All rules inside will inherit rule type. 0 = BLOCK. 1 = BYPASS, 2 = SPOOF, 3 = REDIRECT
namestringYesName of your folder
statusintegerYesStatus of the folder and all rules inside
viastringNoAdd spoof IP or hostname, or proxy identiifer if do=2 or do=3.

control_d_post_profiles_by_profile_id_rules

Custom Rules - Create Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
dointegerYesRule type. 0 = BLOCK. 1 = BYPASS, 2 = SPOOF, 3 = REDIRECT. <<glossary:Do>>
groupintegerNoOptional ID of the folder to create this rule in, root folder if ommited
hostnames[]any[]YesArray of hostnames
statusintegerYesStatus of the rule
viastringNoSpoof/Redirect target. If SPOOF, this can be an IPv4 or hostname. If REDIRECT, this must be a valid proxy identifier. <<glossary:Via>>
via_v6stringNoIf SPOOF this can be a valid IPv6 address (AAAA record)

control_d_put_devices_by_device_id

Modify Endpoint Parameters:
ParameterTypeRequiredDefaultDescription
device_idstringYesDevice/Resolver ID
bump_tlsintegerNoEnable or disable experimental ECH support and TLS bumping
client_countstringNoNumber of devices using this Endpoint
ctrld_custom_configstringNoctrld .toml config file to deploy
ddns_ext_hoststringNoDDNS hostname to query to learn new IPs
ddns_ext_statusintegerNoStatus of DDNS based IP learning. 0 to disable, 1 to enable.
ddns_statusintegerNoStatus of public DDNS endpoint. 1 = enabled, 0 = disable.
ddns_subdomainstringNoDDNS subdomain to expose the IP on
descstringNoAdd a description or comment to the device
learn_ipintegerNoEnable or disable automatic IP learning and logging. 0 to disable, 1 to enable.
legacy_ipv4_statusintegerNoSet this to 1 to generate a legacy IPv4 (and IPv6) DNS resolver, 0 to remove existing one.
namestringNoNew Device name
profile_idstringNoPrimary key of main profile to enforce on this device
profile_id2stringNoPrimary key of a second profile to enforce -1 to remove.
restrictedintegerNoMake this device restricted. 0 to disable, 1 to enable.
statsintegerNoSet analytics level on device. 0 = off, 1 = basic, 2 = full
statusintegerNoUpdate device status. 0 - pending, 1 - active, 2 - soft disabled, 3 - hard disabled

control_d_put_organizations

Modify Organization Parameters:
ParameterTypeRequiredDefaultDescription
addressstringNoPhysical address of this organization
contact_emailstringNoPrimary contact for this sub-organization
contact_namestringNoContact name for the person responsible for this organization
contact_phonestringNoPhone number associated with this organization
namestringNoOrganization name
parent_profilestringNoGlobal Profile ID (PK) to enforce on all created Devices
stats_endpointstringNoPrimary key of desired storage region. See GET /analytics/endpoints
twofa_reqintegerNoIs 2FA/MFA required for memberts of this org. 0 = no, 1 = yes
websitestringNoWebsite URL of this organization

control_d_put_profiles_by_profile_id

Profiles - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
disable_ttlintegerNoDisable profile until specified unix timestamp. ttl = 0 disables previous deactivation.
lock_messagestringNoOptional message to error our with when locked profile is modified
lock_statusintegerNoLock/unlock a profile from being edited.
namestringNoRename profile to this name
passwordstringNoAccount password when unlocking a profile

control_d_put_profiles_by_profile_id_default

Default Rule - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
dointegerNoRule type. 0 = BLOCK. 1 = BYPASS, 2 = SPOOF, 3 = REDIRECT
statusintegerNoStatus of the rule.
viastringNoSpoof/Redirect target. If SPOOF, this can be an IP or hostname. If REDIRECT, this must be a valid proxy identifier.

control_d_put_profiles_by_profile_id_filters

Filters - Batch Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
filtersobject[]NoThe filters value

control_d_put_profiles_by_profile_id_filters_filter_by_filter

Filters - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
filterstringYesFilter name
statusintegerNoStatus of the filter. 1 to enable, 0 to disable.

control_d_put_profiles_by_profile_id_groups_by_folder

Rule Folders - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
folderstringYesFolder ID
dointegerNoAdd a rule type to a folder. All rules inside will inherit rule type
namestringNoRename the folder to this name
statusintegerNoStatus of the folder and all rules inside
viastringNoAdd spoof IP or hostname, or proxy identifer if do=2 or do=3

control_d_put_profiles_by_profile_id_options_by_name

Profiles - Modify Options Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
namestringYesOption name
statusintegerNoStatus of the Profile Option. 1 to enable, 0 to disable
valuestringNoOptional value of the option to set

control_d_put_profiles_by_profile_id_rules

Custom Rules - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
dointegerNoRule type. 0 = BLOCK. 1 = BYPASS, 2 = SPOOF, 3 = REDIRECT.
groupintegerNoID of the folder to create this rule in.
hostnames[]any[]NoArray of hostnames
statusintegerNoStatus of the rule.
viastringNoSpoof/Redirect target. If SPOOF, this can be an IP or hostname. If REDIRECT, this must be a valid proxy identifier. <<glossary:Via>>
via_v6stringNoIf SPOOF this can be a valid IPv6 address (AAAA record)

control_d_put_profiles_by_profile_id_services_by_service

Services - Modify Parameters:
ParameterTypeRequiredDefaultDescription
profile_idstringYesPrimary key (PK) of the profile
servicestringYesService name
dointegerNoRule type. 0 = BLOCK. 1 = BYPASS, 2 = SPOOF, 3 = REDIRECT.
statusintegerNoRule status. 0 = disable. 1 = enabled
viastringNoSpoof/Redirect target. If SPOOF, this can be an IPv4 or hostname. If REDIRECT, this must be a valid proxy identifier. <<glossary:Via>>
via_v6stringNoIf SPOOF this can be a valid IPv6 address (AAAA record)