Uninstall Cortex XDR Agents from endpoints programmatically

R.Pan775442 — Thu, 23 Jan 2025 07:00:15 GMT

Hi,

I would like to programmatically uninstall agents from endpoints but are running into dead ends.

Currently, based on the documentation (https://docs-cortex.paloaltonetworks.com/r/Cortex-XDR/Cortex-XDR-Prevent-Administrator-Guide/Uninstall-the-Cortex-XDR-Agent), we are only able to uninstall the agent via the Action Center or Endpoints page. However, both methods involve an administrator manually triggering the uninstallation process.

The API documentation does not include an API for uninstalling agents and only contain an API for deleting endpoints (https://cortex-panw.stoplight.io/docs/cortex-xdr/a9d8c8076ba24-delete-endpoints). However, the endpoint user can just reconnect since the agent was not uninstalled.

Alternatively, I was looking at running scripts to uninstall agents using the API (https://cortex-panw.stoplight.io/docs/cortex-xdr/7223bea7d2bea-run-script), however, I could not find any references to any scripts that could be used for uninstallation.

Are there any plans to make the uninstallation of agent a part of the public API, or is there a way to enable such for a tenant instance?

Context: I want to programatically uninstall agents from endpoints when certain conditions are fulfiled, by providing a list of endpoint ids to uninstall.

Re: Uninstall Cortex XDR Agents from endpoints programmatically

aspatil — Tue, 28 Jan 2025 10:28:20 GMT

Hello @R.Pan775442 ,

Thanks for reaching out on LiveCommunity!

AFAIK, there is no endpoint API for that. The best method here is to disabled tamper via agent profile and then you can uninstall via python script.

Please refer to below article as well:

https://live.paloaltonetworks.com/t5/cortex-xdr-discussions/uninstalling-cortex-xdr/td-p/532157

If you feel this has answered your query, please let us know by clicking on "mark this as a Solution". Thank you.

topic Re: Uninstall Cortex XDR Agents from endpoints programmatically in Cortex XDR Discussions

Uninstall Cortex XDR Agents from endpoints programmatically

Re: Uninstall Cortex XDR Agents from endpoints programmatically