updateOrgSettings
Update organization-wide settings such as automatic device assignment rules, management connectivity, packet capture, password policy, security controls, tags, and integration options.
Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.
Format:
Authorization: Token {apitoken}
Notes:
- An API token generated for a specific admin has the same privileges as that admin
- An API token is automatically removed if it is not used for more than 90 days
- SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.
In: header
Path Parameters
uuidRequest Body
application/json
Request Body
Organization-wide feature, integration, management, and security settings
whether to allow Mist to look at this org
falseEnable threshold-based device down delivery for AP devices only. When configured it takes effect for AP devices and device_updown_threshold is ignored.
0 <= value <= 2400Policy for hiding API secrets and passwords in responses
Automatic device naming rules for claimed devices
Automatic device profile assignment rules for claimed devices
Automatic site assignment rules for claimed devices
AP automatic firmware upgrade policy for the organization
Legacy CA certificate list used to verify client certificates. If cacerts_configs is provided and non-empty, this field is ignored.
Preferred per-issuer CA certificate configuration with optional OCSP and CRL settings. When provided and non-empty, cacerts is ignored.
Integration settings for Celona
Packet capture integration settings for CloudShark
Common device certificate used by organization settings
Enable threshold-based device down delivery via
- device-updowns webhooks topic,
- Mist Alert Framework; e.g. send AP/SW/GW down event only if AP/SW/GW Up is not seen within the threshold in minutes; 0 - 240, default is 0 (trigger immediate)
0 <= value <= 2400Whether to disallow Mist to analyze pcap files (this is required for marvis pcap)
falseWhether to disable remote shell access for an entire org
falseGateway management defaults for the organization
enable threshold-based gateway tunnel (secure edge tunnels) up-down delivery.
0 <= valueEnable threshold-based device down delivery for Gateway devices only. When configured it takes effect for GW devices and device_updown_threshold is ignored.
0 <= value <= 2400Access settings for organization installer workflows
Integration settings for JCloud
Routing Assurance integration settings for JCloud
Linked Juniper account information for this organization
SRX integration settings for Juniper devices
Role-based Junos web-shell access settings
AI assistant and self-driving feature settings for Marvis
Tunnel settings for organization management connectivity
NAC settings for Mist Access Assurance
Management settings for Mist Edge devices
Configuration defaults for optic ports
Admin credential policy settings for the organization
Packet capture settings for the organization
Organization security controls such as local SSH restrictions
Basic alert delivery settings for the organization
Session Smart Router settings for the organization
Configuration defaults for switches in this organization
Management settings for switches in this organization
Enable threshold-based device down delivery for Switch devices only. When configured it takes effect for SW devices and device_updown_threshold is ignored.
0Configuration for organization synthetic tests
Labels associated with these organization settings
Automatically logout the user when UI session is inactive. 0 means disabled
0 <= value <= 4800Whether to disable UI usage tracking (e.g. Fullstory, Pendo) for the whole organization
falseOptions for organization VPN behavior
PMA feature settings for WAN Assurance
PMA feature settings for Wired Assurance
PMA feature settings for Wireless Assurance
Response Body
application/json
curl -X PUT "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/setting" \ -H "Content-Type: application/json" \ -d '{}'{ "auto_device_naming": { "enable": true, "rules": [ { "match_device": "ap", "prefix": "MIST-", "src": "lldp_port_desc" } ] }, "auto_deviceprofile_assignment": { "enable": true, "rules": [ { "expression": "string", "model": "string", "prefix": "string", "src": "name", "subnet": "string", "suffix": "string", "value": "string" } ] }, "auto_site_assignment": { "enable": true, "rules": [ { "expression": "string", "model": "string", "prefix": "string", "src": "name", "subnet": "string", "suffix": "string", "value": "string" } ] }, "cacerts": [ "string" ], "cloudshark": { "apitoken": "string", "url": "string" }, "device_cert": { "cert": "string", "key": "string" }, "disable_pcap": true, "installer": { "allow_all_sites": true, "extra_site_ids": [ "b069b358-4c97-5319-1f8c-7c5ca64d6ab1" ], "grace_period": 0 }, "mgmt": { "mxtunnel_ids": [ "b069b358-4c97-5319-1f8c-7c5ca64d6ab1" ], "use_mxtunnel": true, "use_wxtunnel": true }, "modified_time": 0, "msp_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1", "name": "string", "password_policy": { "enabled": true, "expiry_in_days": 365, "min_length": 8, "requires_special_char": true, "requires_two_factor_auth": true }, "pcap": { "bucket": "string", "max_pkt_len": 0 }, "pcap_bucket_verified": true, "remote_syslog": { "enabled": true, "send_to_all_servers": true, "servers": [ { "facility": "change-log", "host": "string", "port": 0, "protocol": "udp", "severity": "critical", "tag": "string" } ] }, "security": { "disable_local_ssh": true, "fips_zeroize_password": "string", "limit_ssh_access": true }, "tags": [ "string" ], "ui_idle_timeout": 0}getOrgSettings GET
Return organization-wide settings, including feature flags, automatic device assignment rules, management connectivity, packet capture, security controls, and integration configuration.
setOrgCustomBucket POST
Start custom packet capture bucket setup by saving the bucket name and having Mist write a `MIST_TOKEN` file to the bucket. Complete ownership verification with the verify endpoint by submitting the token contents.