Organizations

Create a new policy

post/organizations/{organizationId}/policies

Request

Base URL: https://api.xfa.tech
URL: https://api.xfa.tech/organizations/{organizationId}/policies
Auth: HTTP bearer

Path parameters

organizationIdstring required

ID of Organization

Request body

policy_idstring required

Unique identifier for the policy

organization_idstring required

Organization identifier

created_by_emailstring

Email of the user who created the policy

created_at_epoch_secondsinteger

Unix epoch seconds when the policy was created

updated_by_emailstring

Email of the user who last updated the policy

updated_at_epoch_secondsinteger

Unix epoch seconds when the policy was last updated

namestring required

Policy name

installedboolean

Require the native application to be installed

unsupportedboolean

Skip unsupported devices automatically

skipboolean

Allow users to skip the token flow

skip_mobileboolean

Allow users to skip the token flow on mobile

skip_desktopboolean

Allow users to skip the token flow on desktop

agentless_allowedboolean

Allow agentless providing of posture

Example request

{
  "os_autoupdate": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_tampered_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "firefox_enhanced_tracking_protection": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "antivirus": {
    "warn": true,
    "requirements": {
      "linux": {
        "allowed_products": []
      },
      "windows": {
        "allowed_products": []
      },
      "macos": {
        "allowed_products": []
      }
    },
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "install_protection": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "unsafe_ai_mode": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_cryptominers": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "created_at_epoch_seconds": 0,
  "screen_sharing": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "remote_management": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "skip_desktop": true,
  "developer_mode": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "unattended_remote_access": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "skip_limit": "",
  "aikido_endpoint": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true,
    "endpoint_token": "endpoint_token"
  },
  "secrets_in_environment": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "updated_by_email": "updated_by_email",
  "disk_encryption": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "ipados_os": {
    "WarnTime": 9,
    "BlockTimeOption": "direct",
    "GoalTime": 6,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 9,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "android_os": {
    "WarnTime": 1,
    "BlockTimeOption": "direct",
    "GoalTime": 7,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 6,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "no_unsigned_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "xfa_version": {
    "GoalTimeInDays": 6,
    "BlockTimeOption": "direct",
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "WarnTimeInDays": 1,
    "BlockTimeInDays": 2,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "no_revoked_signature_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "ios_os": {
    "WarnTime": 1,
    "BlockTimeOption": "direct",
    "GoalTime": 5,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 4,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "dns": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "validation_mode": "exact_match",
    "block": true,
    "dns_servers": [
      "dns_servers",
      "dns_servers"
    ]
  },
  "chrome_do_not_track": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_third_party_ai_coding": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "updated_at_epoch_seconds": 6,
  "no_virtualization": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "windows_os": {
    "WarnTime": 2,
    "BlockTimeOption": "direct",
    "GoalTime": 9,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 7,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "chrome_safebrowsing_enabled": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "organization_id": "organization_id",
  "find_my_device": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "name": "name",
  "no_unnotarized_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "pdf_readers": {
    "WarnTime": 1,
    "BlockTimeOption": "direct",
    "GoalTime": 5,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 5,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "installed": true,
  "autonomous_agents_present": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "chrome_dns_over_https": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "chrome_safebrowsing_enhanced": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "policy_id": "policy_id",
  "linux_os": {
    "WarnTime": 7,
    "BlockTimeOption": "direct",
    "GoalTime": 1,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 1,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "no_games": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "skip": true,
  "windows_recall": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "firefox_https_only": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_permission_hungry": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "integrity_protection": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "unsupported": true,
  "no_hacking_pentest": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "aikido_safe_chain": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "browser": {
    "WarnTime": 1,
    "BlockTimeOption": "direct",
    "GoalTime": 5,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 5,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "remote_login": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "rooted": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "remote_scripting": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "skip_mobile": true,
  "created_by_email": "created_by_email",
  "no_jailbreak_rooting": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "reboot": {
    "GoalTimeInDays": 6,
    "BlockTimeOption": "direct",
    "WarnTimeInDays": 6,
    "BlockTimeInDays": 3,
    "WarnTimeOption": "direct"
  },
  "no_adhoc_signed_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "os": {
    "WarnTime": 1,
    "BlockTimeOption": "direct",
    "GoalTime": 5,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 5,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "secure_boot": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "firefox_enhanced_tracking_protection_strict": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_piracy_p2p": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "jailbroken": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "agentless_allowed": true,
  "no_vpn_clients": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "intune": {
    "warn": true,
    "goal": true,
    "external_enrollment_allowed": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "tenant_ids": [
      "tenant_ids",
      "tenant_ids"
    ],
    "block": true
  },
  "macos_os": {
    "WarnTime": 3,
    "BlockTimeOption": "direct",
    "GoalTime": 4,
    "older_supported_major_versions": {
      "dont_warn": true,
      "dont_block": true
    },
    "BlockTime": 2,
    "WarnTimeOption": "direct",
    "beta_versions": {
      "dont_warn": true,
      "dont_block": true
    }
  },
  "no_untrusted_signer_apps": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "biometrics": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "screen_lock": {
    "max_timeout": 9,
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "firewall": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "firefox_dns_over_https": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "unguarded_elevation": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "vanta": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "password_manager": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  },
  "no_experimental_browsers": {
    "warn": true,
    "goal": true,
    "escalation": {
      "mode": "grace_days",
      "block_after_days": 1
    },
    "block": true
  }
}

Response

Returns the policy