Skip to content
API Reference
/
/
PolicyFilter

GraphQL Overview

Download GraphQL schema
agent.graphql

Queries

Overview

Mutations

Overview

Objects

Overview

Interfaces

Overview

Unions

Overview

Enums

Overview

Inputs

Overview

FindingTypeFilter

Filter for finding types

in
[FindingType!],non-null

Finding types to include in the results

operator
FilterOperator

Operator to apply for matching finding types (IN = match if ANY type is present, AND = match if ALL types are present)

Sample
{
  "in": [
    "INSTRUCTIONS_NOT_CLEAR"
  ],
  "operator": "IN"
}
Referenced in
SessionFilter.findingType
FindingFilter.type
PolicyFilter.findingType

PolicyConditionGroupInput

Input for defining condition groups

agentFilter
AgentFilter

Optional filter on agent properties

toolFilter
ToolFilterInput

Optional filter on tool properties (for TOOL_INVOCATION trigger)

findingFilter
FindingFilter

Optional filter on findings

detectionFilter
DetectionFilter

Optional filter on runtime detections

groups
[PolicyConditionGroupInput!],non-null

Optional nested condition groups

Sample
{
  "agentFilter": {
    "__typename": "AgentFilter"
  },
  "toolFilter": {
    "__typename": "ToolFilterInput"
  },
  "findingFilter": {
    "__typename": "FindingFilter"
  },
  "detectionFilter": {
    "__typename": "DetectionFilter"
  },
  "groups": [
    {
      "__typename": "PolicyConditionGroupInput"
    }
  ]
}
Referenced in
PolicyConditionGroupInput.groups
CreatePolicyInput.conditions
UpdatePolicyInput.conditions

PolicyCreateIssueActionParamsInput

Input for CREATE_ISSUE action parameters

issueSeverity
PolicySeverity!,non-null

Severity to assign when creating an issue

Sample
{
  "issueSeverity": "LOW"
}
Referenced in
PolicyActionInput.createIssueParams

PolicyActionInput

Input for defining policy actions

type
PolicyActionType!,non-null

Type of action to execute

createIssueParams
PolicyCreateIssueActionParamsInput

Parameters for CREATE_ISSUE action (required when type is CREATE_ISSUE)

Sample
{
  "type": "CREATE_ISSUE",
  "createIssueParams": {
    "__typename": "PolicyCreateIssueActionParamsInput"
  }
}
Referenced in
CreatePolicyInput.actions
UpdatePolicyInput.actions

IntRangeFilter

Filter for integer ranges

min
Int

Minimum value (inclusive)

max
Int

Maximum value (inclusive)

Sample
{
  "min": 40,
  "max": 40
}
Referenced in
PolicyFilter.issuesCount

PolicyFilter

Filter for policies

search
String

Text search across policy fields

mode
PolicyModeFilter

Filter by policy mode

status
PolicyStatusFilter

Filter by policy status

triggerType
PolicyTriggerTypeFilter

Filter by trigger type

issuesCount
IntRangeFilter

Filter by issues count range

lastExecutedAt
DateTimeFilter

Filter by last execution time

isDefault
Boolean

Filter by default policies (true = only default, false = only custom, null/undefined = all)

findingType
FindingTypeFilter

Filter by finding types configured in policy conditions

detectionType
DetectionTypeFilter

Filter by detection types configured in policy conditions

Sample
{
  "search": "Example String",
  "mode": {
    "__typename": "PolicyModeFilter"
  },
  "status": {
    "__typename": "PolicyStatusFilter"
  },
  "triggerType": {
    "__typename": "PolicyTriggerTypeFilter"
  },
  "issuesCount": {
    "__typename": "IntRangeFilter"
  },
  "lastExecutedAt": {
    "__typename": "DateTimeFilter"
  },
  "isDefault": true,
  "findingType": {
    "__typename": "FindingTypeFilter"
  },
  "detectionType": {
    "__typename": "DetectionTypeFilter"
  }
}

PolicyModeFilter

Filter for policy mode

in
[PolicyMode!],non-null

Modes to include in the results

Sample
{
  "in": [
    "DRAFT"
  ]
}
Referenced in
PolicyFilter.mode

PolicyStatusFilter

Filter for policy status

in
[PolicyStatus!],non-null

Statuses to include in the results

Sample
{
  "in": [
    "ACTIVE"
  ]
}
Referenced in
PolicyFilter.status

PolicyTriggerTypeFilter

Filter for policy trigger types

in
[PolicyTriggerType!],non-null

Trigger types to include in the results

Sample
{
  "in": [
    "AGENT_CREATED"
  ]
}
Referenced in
PolicyFilter.triggerType

CreatePolicyInput

Input for creating a new policy.

Note: Description is not included in creation input as it is generated asynchronously by AI after the policy is created. Use UpdatePolicyInput to manually set or modify the description later.

name
String!,non-null

Policy name

trigger
PolicyTriggerInput!,non-null

Trigger configuration

conditions
PolicyConditionGroupInput!,non-null

Condition groups

actions
[PolicyActionInput!]!,non-null

Actions to execute

autoResolve
Boolean!,non-null

Automatically resolve issues when conditions are no longer met

Sample
{
  "name": "Example String",
  "trigger": {
    "__typename": "PolicyTriggerInput"
  },
  "conditions": {
    "__typename": "PolicyConditionGroupInput"
  },
  "actions": [
    {
      "__typename": "PolicyActionInput"
    }
  ],
  "autoResolve": true
}

UpdatePolicyInput

Input for updating an existing policy

name
String

Policy name

description
String

Policy description

trigger
PolicyTriggerInput

Trigger configuration

conditions
PolicyConditionGroupInput

Condition groups

actions
[PolicyActionInput!],non-null

Actions to execute

autoResolve
Boolean

Automatically resolve issues when conditions are no longer met

Sample
{
  "name": "Example String",
  "description": "Example String",
  "trigger": {
    "__typename": "PolicyTriggerInput"
  },
  "conditions": {
    "__typename": "PolicyConditionGroupInput"
  },
  "actions": [
    {
      "__typename": "PolicyActionInput"
    }
  ],
  "autoResolve": true
}

Scalars

Overview