previewPolicyImpact¶

QUERYpreviewPolicyImpact

Evaluate a hypothetical ordered ruleset against the catalog and report per-action totals. Rules are walked top-to-bottom; the first matching rule wins per app. V1 evaluates against the full catalog (tenant-agnostic) — the response shape is stable so a future revision can scope to apps observed in the tenant's activity window without breaking callers.

Arguments¶

Argument	Type	Description
`rules`	`[PolicyRuleInput!]!`

Returns¶

PolicyImpactResult!

Request samples¶

cURLPythonPowerShellGoJavaScript

curl -X POST "https://api.taegis.sophos.com/graphql" -H "Authorization: Bearer <access-token>" -H "X-Tenant-ID: <tenant-id>" -H "Content-Type: application/json" -d "{
  \"query\": \"query PreviewPolicyImpact(\$rules: [PolicyRuleInput!]!) { previewPolicyImpact(rules: \$rules) { totalApps blocked warned allowed } }\",
  \"variables\": {
    \"rules\": [
      {
        \"target\": {
          \"conditions\": [
            {
              \"dimension\": \"<dimension>\",
              \"operator\": \"IN\",
              \"values\": [
                \"<values>\"
              ]
            }
          ]
        },
        \"action\": \"BLOCK\"
      }
    ]
  }
}"

import requests

response = requests.post(
    "https://api.taegis.sophos.com/graphql",
    headers={
        "Authorization": "Bearer <access-token>",
        "X-Tenant-ID": "<tenant-id>",
        "Content-Type": "application/json",
    },
    json={   'query': 'query PreviewPolicyImpact($rules: [PolicyRuleInput!]!) { '
             'previewPolicyImpact(rules: $rules) { totalApps blocked warned '
             'allowed } }',
    'variables': {   'rules': [   {   'target': {   'conditions': [   {   'dimension': '<dimension>',
                                                                          'operator': 'IN',
                                                                          'values': [   '<values>']}]},
                                      'action': 'BLOCK'}]}},
)
print(response.json())

$headers = @{
    "Authorization" = "Bearer <access-token>"
    "X-Tenant-ID" = "<tenant-id>"
    "Content-Type" = "application/json"
}
$body = '{
  "query": "query PreviewPolicyImpact($rules: [PolicyRuleInput!]!) { previewPolicyImpact(rules: $rules) { totalApps blocked warned allowed } }",
  "variables": {
    "rules": [
      {
        "target": {
          "conditions": [
            {
              "dimension": "<dimension>",
              "operator": "IN",
              "values": [
                "<values>"
              ]
            }
          ]
        },
        "action": "BLOCK"
      }
    ]
  }
}'
Invoke-RestMethod -Method POST -Uri "https://api.taegis.sophos.com/graphql" -Headers $headers -Body $body -ContentType "application/json"

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.taegis.sophos.com/graphql", strings.NewReader(`{
  "query": "query PreviewPolicyImpact($rules: [PolicyRuleInput!]!) { previewPolicyImpact(rules: $rules) { totalApps blocked warned allowed } }",
  "variables": {
    "rules": [
      {
        "target": {
          "conditions": [
            {
              "dimension": "<dimension>",
              "operator": "IN",
              "values": [
                "<values>"
              ]
            }
          ]
        },
        "action": "BLOCK"
      }
    ]
  }
}`))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer <access-token>")
    req.Header.Set("X-Tenant-ID", "<tenant-id>")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

const response = await fetch("https://api.taegis.sophos.com/graphql", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <access-token>",
    "X-Tenant-ID": "<tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "query": "query PreviewPolicyImpact($rules: [PolicyRuleInput!]!) { previewPolicyImpact(rules: $rules) { totalApps blocked warned allowed } }",
  "variables": {
    "rules": [
      {
        "target": {
          "conditions": [
            {
              "dimension": "<dimension>",
              "operator": "IN",
              "values": [
                "<values>"
              ]
            }
          ]
        },
        "action": "BLOCK"
      }
    ]
  }
}),
});
const data = await response.json();
console.log(data);