---
updatedAt: 2026-06-16T18:46:24.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Display subsets of information for a patch policy

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.32.0",
    "title": "Classic API",
    "license": {
      "name": "Jamf API License Agreement",
      "url": "https://developer.jamf.com/developer-guide/docs/api-license-agreement"
    }
  },
  "security": [
    {
      "basicAuth": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "paths": {
    "/patchpolicies/id/{id}/subset/{subset}": {
      "get": {
        "tags": [
          "patchpolicies"
        ],
        "summary": "Display subsets of information for a patch policy",
        "operationId": "findPatchPoliciesByIdSubset",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID to filter by",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "subset",
            "in": "path",
            "required": true,
            "description": "Subset to filter by",
            "schema": {
              "type": "string",
              "enum": [
                "General",
                "Scope",
                "UserInteraction"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/patch_policy"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/patch_policy"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "id_name": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1
          },
          "name": {
            "type": "string"
          }
        }
      },
      "patch_policy": {
        "type": "object",
        "properties": {
          "general": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "example": 1
              },
              "name": {
                "type": "string",
                "example": "Google Chrome - 62.0.3202.75"
              },
              "enabled": {
                "type": "boolean",
                "example": true
              },
              "target_version": {
                "type": "string",
                "example": "62.0.3202.75"
              },
              "release_date": {
                "type": "integer",
                "example": 1509048027663
              },
              "incremental_updates": {
                "type": "boolean",
                "example": false
              },
              "reboot": {
                "type": "boolean"
              },
              "minimum_os": {
                "type": "string",
                "example": 10.9
              },
              "kill_apps": {
                "type": "array",
                "items": {
                  "properties": {
                    "kill_app": {
                      "type": "object",
                      "properties": {
                        "kill_app_name": {
                          "type": "string",
                          "example": "Google Chrome.app"
                        },
                        "kill_app_bundle_id": {
                          "type": "string",
                          "example": "com.google.Chrome"
                        }
                      }
                    }
                  }
                }
              },
              "distribution_method": {
                "type": "string",
                "enum": [
                  "selfservice",
                  "prompt"
                ]
              },
              "allow_downgrade": {
                "type": "boolean"
              },
              "patch_unknown": {
                "type": "boolean",
                "description": "Set to true to patch versions unidentified by Jamf Pro patch reporting"
              }
            },
            "required": [
              "name",
              "target_version"
            ]
          },
          "scope": {
            "type": "object",
            "properties": {
              "all_computers": {
                "type": "boolean"
              },
              "computers": {
                "type": "array",
                "items": {
                  "properties": {
                    "computer": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer",
                          "example": 1
                        },
                        "name": {
                          "type": "string",
                          "example": "Joe's MacBook Pro"
                        },
                        "udid": {
                          "type": "string",
                          "example": "55900BDC-347C-58B1-D249-F32244B11D30"
                        }
                      }
                    }
                  }
                }
              },
              "computer_groups": {
                "type": "array",
                "items": {
                  "properties": {
                    "computer_group": {
                      "$ref": "#/components/schemas/id_name"
                    }
                  }
                }
              },
              "buildings": {
                "type": "array",
                "items": {
                  "properties": {
                    "building": {
                      "$ref": "#/components/schemas/id_name"
                    }
                  }
                }
              },
              "departments": {
                "type": "array",
                "items": {
                  "properties": {
                    "department": {
                      "$ref": "#/components/schemas/id_name"
                    }
                  }
                }
              },
              "limitations": {
                "type": "object",
                "properties": {
                  "network_segments": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "network_segment": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  },
                  "ibeacons": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "ibeacon": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  }
                }
              },
              "exclusions": {
                "type": "object",
                "properties": {
                  "computers": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "computer": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer",
                              "example": 1
                            },
                            "name": {
                              "type": "string",
                              "example": "Joe's MacBook Pro"
                            },
                            "udid": {
                              "type": "string",
                              "example": "55900BDC-347C-58B1-D249-F32244B11D30"
                            }
                          }
                        }
                      }
                    }
                  },
                  "computer_groups": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "computer_group": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  },
                  "buildings": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "building": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  },
                  "departments": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "department": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  },
                  "network_segments": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "network_segment": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  },
                  "ibeacons": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "ibeacon": {
                          "$ref": "#/components/schemas/id_name"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "user_interaction": {
            "type": "object",
            "properties": {
              "install_button_text": {
                "type": "string",
                "example": "Update"
              },
              "self_service_description": {
                "type": "string",
                "example": "Latest update for Google Chrome"
              },
              "self_service_icon": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "example": 1
                  },
                  "filename": {
                    "type": "string",
                    "example": "Chrome.png"
                  },
                  "uri": {
                    "type": "string",
                    "example": "https://jssURL.jamfcloud.com/iconservlet/?id=1"
                  }
                }
              },
              "notifications": {
                "type": "object",
                "properties": {
                  "notification_enabled": {
                    "type": "boolean",
                    "example": true
                  },
                  "notification_type": {
                    "type": "string",
                    "enum": [
                      "Self Service",
                      "Self Service and Notification Center"
                    ]
                  },
                  "notification_subject": {
                    "type": "string",
                    "example": "Google Chrome Update Available"
                  },
                  "notification_message": {
                    "type": "string",
                    "example": "An update for Google Chrome is available within Self Service"
                  },
                  "reminders": {
                    "type": "object",
                    "properties": {
                      "notification_reminders_enabled": {
                        "type": "boolean",
                        "example": true
                      },
                      "notification_reminder_frequency": {
                        "type": "integer",
                        "example": 1
                      }
                    }
                  }
                }
              },
              "deadlines": {
                "type": "object",
                "properties": {
                  "deadline_enabled": {
                    "type": "boolean",
                    "example": true
                  },
                  "deadline_period": {
                    "type": "integer",
                    "example": 7
                  }
                }
              },
              "grace_period": {
                "type": "object",
                "properties": {
                  "grace_period_duration": {
                    "type": "integer",
                    "example": 15,
                    "description": "Number of minutes to wait before automatically closing all apps required to be closed for an update"
                  },
                  "notification_center_subject": {
                    "type": "string",
                    "example": "Important"
                  },
                  "message": {
                    "type": "string",
                    "example": "$APP_NAMES will quit in $DELAY_MINUTES minutes so that $SOFTWARE_TITLE can be updated. Save anything you are working on and quit the app(s)"
                  }
                }
              }
            }
          },
          "software_title_configuration_id": {
            "type": "integer",
            "example": 1
          }
        }
      }
    }
  }
}
```