Create a device posture check policy

post

Authorizations

cookieapi_token

defguard_sessionstringRequired

Body

application/json

Request body for creating or updating a device posture check policy.

allow_prerelease_clientbooleanRequired

descriptionstring · nullableOptional

min_desktop_client_versionstring · nullableOptional

min_mobile_client_versionstring · nullableOptional

namestringRequired

Responses

201

Device posture check policy created.

application/json

API response type for a device posture check policy.

allow_prerelease_clientbooleanRequired

descriptionstring · nullableOptional

idinteger · int64Required

locationsinteger · int64[]Required

IDs of VPN locations this policy is assigned to.

min_desktop_client_versionstring · nullableOptional

min_mobile_client_versionstring · nullableOptional

namestringRequired

400

Invalid request data.

application/json

401

Session is missing or invalid.

application/json

403

Requires admin privileges and an active enterprise license.

application/json

500

Unable to create device posture check policy.

application/json

post/api/v1/device-posture

HTTPcURLJavaScriptPython

POST /api/v1/device-posture HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 319

{
  "allow_prerelease_client": true,
  "description": null,
  "min_desktop_client_version": null,
  "min_mobile_client_version": null,
  "name": "text",
  "os_rules": [
    {
      "ad_domain_joined_required": null,
      "antivirus_required": null,
      "disk_encryption_required": null,
      "min_os_version": null,
      "os_type": "windows",
      "windows_security_update_max_age": null
    }
  ]
}

{
  "allow_prerelease_client": true,
  "description": null,
  "id": 1,
  "locations": [
    1
  ],
  "min_desktop_client_version": null,
  "min_mobile_client_version": null,
  "name": "text",
  "os_rules": [
    {
      "ad_domain_joined_required": null,
      "antivirus_required": null,
      "disk_encryption_required": null,
      "min_os_version": null,
      "os_type": "windows",
      "windows_security_update_max_age": null
    }
  ]
}