Create Device Posture Rule

Create a new Device Posture Rule.

Request

Path Params

identifier

string

required

Body Params application/json

description

string

optional

The description of the Device Posture Rule.

Example:

The rule for admin serial numbers

expiration

string

optional

Sets the expiration time for a posture check result. If empty, the result remains valid until it is overwritten by new data from the WARP client.

Example:

input

object (schemas-input)

optional

The value to be checked against.

string

optional

API uuid tag.

<= 36 characters

Example:

f174e90a-fafe-4643-bbbc-4a0ed4fc8415

match

array[object (match_item) {1}]

optional

The conditions that the client must match to run the rule.

platform

enum<string>

optional

Allowed values:

windowsmaclinuxandroidios

Example:

windows

name

string

required

The name of the Device Posture Rule.

Example:

Admin Serial Numbers

schedule

string

optional

Polling frequency for the WARP client posture check. Default: 5m (poll every five minutes). Minimum: 1m.

Example:

type

enum<string>

required

The type of Device Posture Rule.

Allowed values:

fileapplicationserial_numbertaniumgatewaywarp

Example:

file

Example

{
    "description": "The rule for admin serial numbers",
    "expiration": "1h",
    "input": {
        "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415"
    },
    "match": [
        {
            "platform": "windows"
        }
    ],
    "name": "Admin Serial Numbers",
    "schedule": "1h",
    "type": "file"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Create Device Posture Rule response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object (device-posture-rules)

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "description": "The rule for admin serial numbers",
        "expiration": "1h",
        "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
        "input": {
            "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415"
        },
        "match": [
            {
                "platform": "windows"
            }
        ],
        "name": "Admin Serial Numbers",
        "schedule": "1h",
        "type": "file"
    },
    "success": true
}

🟢200Create Device Posture Rule response failure