Palo Alto Networks · JSON Structure

Cortex Xdr Api Endpoint Structure

An endpoint enrolled in Cortex XDR protection.

Type: object Properties: 20
Cloud SecurityCybersecurityFirewallNetwork SecuritySASESOARThreat IntelligenceXDR

Endpoint is a JSON Structure definition published by Palo Alto Networks, describing 20 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

endpoint_id endpoint_name endpoint_type endpoint_status os_type ip users domain alias first_seen last_seen content_version installation_package active_directory install_date endpoint_version is_isolated isolation_reason scan_status group_name

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/json-structure/cortex-xdr-api-endpoint-structure.json",
  "name": "Endpoint",
  "description": "An endpoint enrolled in Cortex XDR protection.",
  "type": "object",
  "properties": {
    "endpoint_id": {
      "type": "string",
      "description": "Unique endpoint identifier."
    },
    "endpoint_name": {
      "type": "string",
      "description": "Endpoint hostname."
    },
    "endpoint_type": {
      "type": "string",
      "enum": [
        "SERVER",
        "WORKSTATION",
        "LAPTOP"
      ]
    },
    "endpoint_status": {
      "type": "string",
      "enum": [
        "CONNECTED",
        "DISCONNECTED",
        "LOST",
        "UNINSTALLED"
      ]
    },
    "os_type": {
      "type": "string",
      "enum": [
        "AGENT_OS_WINDOWS",
        "AGENT_OS_LINUX",
        "AGENT_OS_MAC"
      ]
    },
    "ip": {
      "type": "array",
      "description": "IP addresses assigned to the endpoint.",
      "items": {
        "type": "string"
      }
    },
    "users": {
      "type": "array",
      "description": "Users logged into the endpoint.",
      "items": {
        "type": "string"
      }
    },
    "domain": {
      "type": "string"
    },
    "alias": {
      "type": "string"
    },
    "first_seen": {
      "type": "int32",
      "description": "First connection timestamp as Unix epoch milliseconds."
    },
    "last_seen": {
      "type": "int32",
      "description": "Last connection timestamp as Unix epoch milliseconds."
    },
    "content_version": {
      "type": "string",
      "description": "Cortex XDR agent content version."
    },
    "installation_package": {
      "type": "string"
    },
    "active_directory": {
      "type": "string"
    },
    "install_date": {
      "type": "int32"
    },
    "endpoint_version": {
      "type": "string",
      "description": "Cortex XDR agent version."
    },
    "is_isolated": {
      "type": "string",
      "enum": [
        "AGENT_ISOLATED",
        "AGENT_UNISOLATED",
        "PENDING_ISOLATION",
        "PENDING_UNISOLATION"
      ]
    },
    "isolation_reason": {
      "type": "string"
    },
    "scan_status": {
      "type": "string",
      "enum": [
        "SCAN_STATUS_NONE",
        "SCAN_STATUS_PENDING",
        "SCAN_STATUS_IN_PROGRESS",
        "SCAN_STATUS_DONE",
        "SCAN_STATUS_FAILED",
        "SCAN_STATUS_CANCELLED"
      ]
    },
    "group_name": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}