Organizations

Create a new application

post/organizations/{organizationId}/applications

Request

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

Path parameters

organizationIdstring required

ID of Organization

Request body

organizationIDstring required

ID of the organization

applicationIDstring required

ID of the application

policyIDstring

ID of the policy

Type of the application

testKeystring

Test key

namestring required

Name of the application

iconUrlstring

Icon URL of the application

allowedApplicationDomainRegexesstring[] required

Allowed application domain regexes

publicCertsstring[] required

Public certificates

SAMLMetadataUrlstring required

SAML Metadata URL

clientSecretstring

Client secret

SSOUrlstring required

SSO URL

issuerstring required

Issuer

customSessionDurationInHoursinteger

Custom session duration in hours

filteredEmailstring[] required

Filtered email addresses

filterMobileboolean

Filter mobile devices

filterDesktopboolean

Filter desktop devices

filteredOSstring[]

Filtered operating systems

enableMfaboolean

Enable MFA

enableMfaAutoApproveFirstDeviceboolean

Enable MFA auto-approve first device

alwaysVerifyMfaboolean

Double Identity Verification

uniquePurpose'DashboardDemo'

Unique purpose of the application

enabledboolean

Enabled

allowedEmailDomainsstring[]

Allowed email-domain allow-list for the IdP connection

mfaFirstboolean

Run passkey/MFA before device posture (IdP connection)

requireEmailVerificationboolean

Require recovery-email proof at onboarding (IdP connection)

IdPProvider'Google'

Branded provider of an IdP connection, such as a Google Workspace connection. Only valid when type is IdP; unrelated to the Google type (Workspace device discovery). Cannot be cleared once set.

Example request

{
  "policies": {
    "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 application