PolicyResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/snyk/main/json-schema/snyk-policy-response-schema.json",
  "title": "PolicyResponse",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/snyk-policies-api-openapi.yml#/components/schemas/PolicyResponse",
  "additionalProperties": false,
  "properties": {
    "attributes": {
      "$ref": "#/$defs/PolicyResponseAttributes"
    },
    "id": {
      "description": "A unique identifier for this particular occurrence of the policy.",
      "format": "uuid",
      "type": "string"
    },
    "type": {
      "enum": [
        "policy"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "attributes"
  ],
  "type": "object",
  "$defs": {
    "PolicyActionIgnore": {
      "additionalProperties": false,
      "properties": {
        "data": {
          "$ref": "#/$defs/PolicyActionIgnoreData"
        }
      },
      "required": [
        "data"
      ],
      "type": "object"
    },
    "PolicyActionIgnoreData": {
      "oneOf": [
        {
          "$ref": "#/$defs/PolicyActionIgnoreDataWontFix"
        },
        {
          "$ref": "#/$defs/PolicyActionIgnoreDataTemporaryIgnore"
        },
        {
          "$ref": "#/$defs/PolicyActionIgnoreDataNotVulnerable"
        }
      ],
      "type": "object"
    },
    "PolicyActionIgnoreDataNotVulnerable": {
      "additionalProperties": false,
      "properties": {
        "expires": {
          "format": "date-time",
          "type": "string"
        },
        "ignore_type": {
          "enum": [
            "not-vulnerable"
          ],
          "type": "string"
        },
        "reason": {
          "maxLength": 10000,
          "type": "string"
        }
      },
      "required": [
        "ignore_type"
      ],
      "type": "object"
    },
    "PolicyActionIgnoreDataTemporaryIgnore": {
      "additionalProperties": false,
      "properties": {
        "expires": {
          "format": "date-time",
          "type": "string"
        },
        "ignore_type": {
          "enum": [
            "temporary-ignore"
          ],
          "type": "string"
        },
        "reason": {
          "maxLength": 10000,
          "type": "string"
        }
      },
      "required": [
        "ignore_type",
        "expires"
      ],
      "type": "object"
    },
    "PolicyActionIgnoreDataWontFix": {
      "additionalProperties": false,
      "properties": {
        "expires": {
          "format": "date-time",
          "type": "string"
        },
        "ignore_type": {
          "enum": [
            "wont-fix"
          ],
          "type": "string"
        },
        "reason": {
          "maxLength": 10000,
          "type": "string"
        }
      },
      "required": [
        "ignore_type"
      ],
      "type": "object"
    },
    "PolicyCondition": {
      "additionalProperties": false,
      "properties": {
        "field": {
          "description": "field refers to the type of identifier used in the condition of the policy.  The available value is versioned and hierarchical:\n- `snyk/asset/finding/v1` : identity of the finding scoped to a Snyk assets (e.g. a repository).\nFor a given issue, `snyk/asset/finding/v1` can be extracted from the `key_asset` field in the [issues API](https://apidocs.snyk.io/?version=2024-10-15#get-/orgs/-org_id-/issues). \nIn addition, finding identities can be extracted from the fingerprints section of the SARIF, which is accessible via the Snyk CLI. More details can be found in the [CLI documentation](https://docs.snyk.io/snyk-cli/scan-and-maintain-projects-using-the-cli/snyk-cli-for-snyk-code/view-snyk-code-cli-results#export-test-results).\n",
          "enum": [
            "snyk/asset/finding/v1"
          ],
          "type": "string"
        },
        "operator": {
          "description": "Operator for the field to value matching. Currently\nonly 'includes' is supported, which does an exact\nstring match on the value.\n",
          "enum": [
            "includes"
          ],
          "type": "string"
        },
        "value": {
          "description": "The value of the field to match on.\n",
          "type": "string"
        }
      },
      "required": [
        "field",
        "operator",
        "value"
      ],
      "type": "object"
    },
    "PolicyConditionsGroup": {
      "properties": {
        "conditions": {
          "items": {
            "$ref": "#/$defs/PolicyCondition"
          },
          "maxItems": 1,
          "minItems": 1,
          "type": "array"
        },
        "logical_operator": {
          "description": "The logical operator for the policy condition. Currently only 'and' is supported.",
          "enum": [
            "and"
          ],
          "type": "string"
        }
      },
      "required": [
        "logical_operator",
        "conditions"
      ],
      "type": "object"
    },
    "PolicyResponseAttributes": {
      "additionalProperties": false,
      "properties": {
        "action": {
          "$ref": "#/$defs/PolicyActionIgnore"
        },
        "action_type": {
          "enum": [
            "ignore"
          ],
          "type": "string"
        },
        "conditions_group": {
          "$ref": "#/$defs/PolicyConditionsGroup"
        },
        "created_at": {
          "format": "date-time",
          "type": "string"
        },
        "created_by": {
          "$ref": "#/$defs/Principal"
        },
        "name": {
          "type": "string"
        },
        "review": {
          "$ref": "#/$defs/PolicyReview"
        },
        "updated_at": {
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "name",
        "conditions_group",
        "action",
        "action_type",
        "review",
        "created_at",
        "updated_at"
      ],
      "type": "object"
    },
    "PolicyReview": {
      "description": "Review status.",
      "enum": [
        "pending",
        "approved",
        "rejected",
        "not-required"
      ],
      "type": "string"
    },
    "Principal": {
      "properties": {
        "email": {
          "type": "string"
        },
        "id": {
          "description": "The Snyk ID corresponding to this user or service account that created the policy",
          "format": "uuid",
          "type": "string"
        },
        "name": {
          "description": "Name of the user or service account that created the policy",
          "type": "string"
        }
      },
      "required": [
        "name",
        "id"
      ],
      "type": "object"
    }
  }
}