> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xdr-5-api/api-release-notes.md).

# What's new in this release

* [API Release Notes for Cortex XDR](#api-release-notes-for-cortex-xdr)
  * [Cortex XDR 5.2](#cortex-xdr-52)
  * [Cortex XDR 5.1](#cortex-xdr-51)
  * [Cortex XDR 5.0](#cortex-xdr-50)

<br>

## Cortex XDR 5.2

| Product Name                  | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent Configurations          | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Application Security (AppSec) | <p><strong>Paths Added</strong><br>- <code>GET /public\_api/appsec/v1/code-to-cloud/coverage</code>: Retrieve the Code-to-Cloud coverage ratio — the percentage of assets with a traceable lineage between code and cloud. Use <code>direction</code> to select which way lineage is traced and <code>type</code> to select the asset kind.<br>- <code>GET /public\_api/appsec/v1/package\_explorer/packages/{name}/versions/{version}</code>: Retrieve details for a specific package version, including vulnerability counts and where the package is used.<br>- <code>GET /public\_api/appsec/v1/application/{applicationId}/assets/addable</code>: List assets that can be added to an application.<br>- <code>GET /public\_api/appsec/v1/application/{applicationId}/assets/removable</code>: List assets that can be removed from an application.<br>- <code>POST /public\_api/appsec/v1/application/{applicationId}/assets/override</code>: Add or remove assets, overriding the application's asset selection criteria.<br>- <code>GET /public\_api/appsec/v1/application/{applicationId}/assets/overrides</code>: List the override actions applied to an application.<br>- <code>DELETE /public\_api/appsec/v1/application/{applicationId}/assets/overrides/{actionId}</code>: Revert a single asset override action.<br><br><strong>Updated Schemas</strong><br>- <code>CreateOrModifyCustomRuleRequestParams</code>: Added <code>category</code>, <code>subCategory</code>, <code>frameworks</code>, <code>cspmRuleId</code>, and <code>clonedFromRuleId</code>.<br>- <code>DetectionRule</code>: Added <code>complianceStandards</code>, <code>cspmRuleId</code>, <code>cspmTypeId</code>, and <code>findingTypeName</code>.<br>- <code>CustomRuleScanner</code>: Added <code>IAC</code> and <code>SECRETS</code> scanner values.<br>- <code>GetRulesResponseObject</code>: Added <code>nextOffset</code> to support offset pagination.<br><br><strong>Schemas Added</strong><br>- <code>CoveragePublicApiResponse</code>, <code>CodeToCloudDirection</code>, <code>CodeToCloudDashboardType</code>: Code-to-Cloud coverage response and query enums.<br>- <code>PackageExplorerResponse</code>, <code>PackageType</code>, <code>VulnerabilityCounts</code>, <code>UsedInCounts</code>: Package Explorer response types.<br>- <code>ManageableAsset</code>, <code>GetManageableAssetsResponse</code>, <code>AddableAssetFilter</code>, <code>OverrideAssetsRequest</code>, <code>OverrideAssetsResponse</code>, <code>ApplicationAssetOverrideResponse</code>, <code>RevertOverridesResponse</code>, <code>OperationType</code>: Application asset management types.<br>- <code>ComplianceStandard</code>, <code>Control</code>: Compliance metadata attached to detection rules.<br><br><strong>Schemas Removed</strong><br>- <code>IACSecurity</code> and <code>secretsSecurity</code> were replaced by the <code>CustomRuleScanner</code> enum values.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Asset Compliance              | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Broker VM                     | <p><strong>New specs published</strong><br>Broker VM endpoints are now documented in two specs, reflecting the two places a Broker VM is managed from:<br>- <strong>Cortex Broker Public API (tenant-side)</strong> (<code>broker-papi.yaml</code>): manage brokers from the Cortex tenant.<br>- <strong>Cortex Broker Direct Public API (on-appliance)</strong> (<code>broker-direct-papi.yaml</code>): configure an individual appliance directly.<br><br><strong>Paths included (tenant-side)</strong><br>- <code>GET /public\_api/v1/brokers/</code>: List brokers.<br>- <code>GET /public\_api/v1/brokers/images/</code>: List available broker images.<br>- <code>GET /public\_api/v1/brokers/action\_status/{action\_id}/</code>: Poll the status of an asynchronous broker action.<br>- <code>POST /public\_api/v1/brokers/registration\_token/</code>: Generate a registration token.<br>- <code>POST /public\_api/v1/brokers/{device\_id}/</code>: Update broker settings.<br>- <code>POST /public\_api/v1/brokers/{device\_id}/delete/</code>, <code>/reboot/</code>, <code>/shutdown/</code>, <code>/upgrade/</code>: Lifecycle actions.<br>- <code>GET /public\_api/v1/brokers/{device\_id}/applets/{applet\_name}/</code>, <code>POST .../activate/</code>, <code>.../deactivate/</code>, <code>.../config/</code>: Manage applets.<br>- <code>POST /public\_api/v1/brokers/{device\_id}/applets/network\_mapper/scan\_now/</code>: Trigger an on-demand network mapper scan.<br>- <code>POST /public\_api/v1/brokers/{device\_id}/applets/wec/wef\_cert/</code>: Upload a WEF certificate.<br>- <code>POST /public\_api/v1/brokers/{device\_id}/logs/generate/</code>, <code>GET .../logs/status/</code>, <code>GET .../logs/download/</code>: Generate and retrieve broker logs.<br><br><strong>Paths included (on-appliance)</strong><br>- <code>POST /public\_api/v1/auth/token</code>, <code>POST /public\_api/v1/auth/reset-initial-password</code>: Appliance authentication.<br>- <code>POST /public\_api/v1/register</code>: Register the appliance with a tenant.<br>- <code>POST /public\_api/v1/network/interface</code>, <code>/internal\_subnet</code>, <code>/ntp</code>, <code>/proxy</code>, <code>/ssl\_certificate</code>, <code>/trusted\_ca</code>: Appliance network configuration.<br>- <code>POST /public\_api/v1/logs</code>: Retrieve appliance logs.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Cases APIs                    | <p><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/case/timeline/{case-id}/</code>: Retrieve the timeline for a case.<br>- <code>POST /public\_api/v1/case/timeline/{case-id}/add\_record/</code>: Add a record to a case timeline.<br><br><strong>Updated Paths</strong><br>- <code>POST /public\_api/v1/case/search</code>: Added <code>modification\_time</code> as a supported filter and sort field. <code>last\_update\_time</code> is still accepted for backward compatibility but is deprecated — use <code>modification\_time</code> instead.<br><br><strong>Updated Schemas</strong><br>- <code>Case</code>: Added <code>access\_mode</code>, <code>case\_team</code>, <code>asset\_group\_ids</code>, and <code>asset\_group\_names</code>.<br>- <code>UpdateCase</code>: Added <code>access\_mode</code> and <code>case\_team</code>.<br>- <code>Asset</code>: Added <code>asset\_tags</code> and <code>asset\_group\_names</code>.<br>- Response wrapper: Corrected to return a <code>reply</code> object rather than the <code>err\_code</code> / <code>err\_msg</code> / <code>err\_extra</code> shape previously documented.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| CIEM                          | <p><strong>Paths Added</strong><br>- <code>GET /public\_api/ciem/v1/access/source/{source\_uai}</code>: Retrieve the resources a source identity can access.<br>- <code>GET /public\_api/ciem/v1/access/destination/{destination\_uai}</code>: Retrieve the identities that can access a destination resource.<br>- <code>GET /public\_api/ciem/v1/access/granter/{granter\_uai}</code>: Retrieve the access conferred by a permission-granting entity.<br>- <code>GET /public\_api/ciem/v1/assets/{assetId}/least-privileged-access</code>: Retrieve a least-privilege access recommendation for an asset.<br><br><strong>Deprecated Paths</strong><br>- <code>POST /public\_api/v1/ciem/access/search</code> is deprecated. Use the three <code>GET</code> access endpoints above instead.<br><br><strong>Note</strong>: The deprecated endpoint continues to function for backward compatibility but will not receive further enhancements.<br><br><strong>Schemas Added</strong><br>- <code>CiemAccessGetRequest</code>, <code>CiemAccessGetResponse</code>, <code>CiemAccessGetEntry</code>, <code>GetFilterObject</code>: Request/response types for the access GET endpoints.<br>- <code>CustomLeastPrivilegedAccessResponseDto</code>, <code>LeastPrivilegedPermissionVerdict</code>, <code>RecommendationSnippetsDto</code>: Least-privilege recommendation types.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Cloud Onboarding              | <p><strong>Updated Schemas</strong><br>- <code>InstanceAdditionalCapabilities</code>: Added <code>upload\_files\_to\_wildfire</code> to control whether scanned files are uploaded to WildFire.<br>- <code>InstanceAuditLogsConfig</code>: Added <code>is\_control\_tower\_byob</code> for AWS Control Tower bring-your-own-bucket audit log collection.<br>- <code>InstanceScopeModifications</code>: Added <code>organizational\_units</code>, <code>folders</code>, <code>management\_groups</code>, and <code>onboard\_only\_mode</code> for scoping onboarding across AWS OUs, GCP folders, and Azure management groups.<br><br><strong>Schemas Added</strong><br>- <code>InstanceOUConfig</code>: Organizational unit configuration for scoped onboarding.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Compliance                    | <p><strong>Compliance v2 APIs</strong><br>A <code>v2</code> set of compliance endpoints has been added for managing custom standards, controls, and categories. The existing <code>v1</code> compliance endpoints are unchanged and remain available.<br><br><strong>Paths Added — Standards</strong><br>- <code>GET /public\_api/v2/compliance/standards</code>, <code>POST /public\_api/v2/compliance/standards</code>: List and create standards.<br>- <code>GET /public\_api/v2/compliance/standards/{standard\_id}</code>, <code>POST /public\_api/v2/compliance/standards/{standard\_id}</code>, <code>DELETE /public\_api/v2/compliance/standards/{standard\_id}</code>: Retrieve, update, and delete a standard.<br>- <code>POST /public\_api/v2/compliance/standards/{standard\_id}/clone</code>: Clone an existing standard.<br><br><strong>Paths Added — Import and export</strong><br>- <code>POST /public\_api/v2/compliance/standards/export</code>, <code>GET /public\_api/v2/compliance/standards/export/{job\_id}</code>, <code>GET /public\_api/v2/compliance/standards/export/{job\_id}/download</code>: Start an export job, poll its status, and download the result.<br>- <code>POST /public\_api/v2/compliance/standards/import</code>, <code>GET /public\_api/v2/compliance/standards/import/{job\_id}</code>: Start an import job and poll its status.<br><br><strong>Paths Added — Controls</strong><br>- <code>GET /public\_api/v2/compliance/controls</code>, <code>POST /public\_api/v2/compliance/controls</code>: List and create controls.<br>- <code>GET /public\_api/v2/compliance/controls/{control\_id}</code>, <code>POST /public\_api/v2/compliance/controls/{control\_id}</code>, <code>DELETE /public\_api/v2/compliance/controls/{control\_id}</code>: Retrieve, update, and delete a control.<br>- <code>POST /public\_api/v2/compliance/controls/bulk</code>, <code>POST /public\_api/v2/compliance/controls/bulk-update</code>, <code>POST /public\_api/v2/compliance/controls/delete</code>: Bulk create, update, and delete controls.<br><br><strong>Paths Added — Categories</strong><br>- <code>GET /public\_api/v2/compliance/categories</code>, <code>POST /public\_api/v2/compliance/categories</code>: List and create categories.<br>- <code>POST /public\_api/v2/compliance/categories/{category\_id}</code>, <code>DELETE /public\_api/v2/compliance/categories/{category\_id}</code>: Update and delete a category.<br><br><strong>Schemas Added</strong><br>- <code>PapiStandardCreate</code>, <code>PapiStandardUpdate</code>, <code>PapiStandardResponse</code>, <code>PapiControlCreate</code>, <code>PapiControlUpdate</code>, <code>PapiControlResponse</code>, <code>PapiCategoryCreate</code>, <code>PapiCategoryUpdate</code>, <code>PapiCategoryResponse</code>, <code>PapiPaginatedResponse</code>, <code>PapiBulkDeleteControls</code>, <code>BulkControlResult</code>, <code>BulkControlResultItem</code>, <code>BulkUpdateControlItem</code>, <code>CloneStandardRequest</code>, <code>CloneStandardResponse</code>, <code>CloneStandardCategoryResponse</code>, <code>CloneStandardSubcategoryResponse</code>, <code>CloneStandardControlResponse</code>, <code>ExportRequest</code>, <code>ExportJobResponse</code>, <code>ExportStatusResponse</code>, <code>ImportJobResponse</code>, <code>ImportStatusResponse</code>, <code>ImportStandardResult</code>.</p> |
| Cortex Platform               | <p><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/tags/agents/create</code>: Create an endpoint tag.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| CSPM Policies                 | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| CWP                           | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Detection Rules               | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Forensics                     | <p><strong>New spec published</strong><br>Cortex XDR Forensics REST API (<code>forensics-papi.json</code>) supports forensic investigations and evidence collection.<br><br><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/forensics/investigations</code>: Create or retrieve forensic investigations.<br>- <code>POST /public\_api/v1/forensics/investigations/collections</code>: Manage collections within an investigation.<br>- <code>POST /public\_api/v1/forensics/investigations/collections/get\_data</code>: Retrieve collected data.<br>- <code>POST /public\_api/v1/forensics/investigations/collections/hunt</code>: Run a hunt across collected data.<br>- <code>POST /public\_api/v1/forensics/investigations/collections/triage</code>: Trigger triage collection.<br>- <code>POST /public\_api/v1/forensics/investigations/collections/triage/get\_files</code>: Retrieve triage files.<br>- <code>POST /public\_api/v1/forensics/investigations/collections/triage/host\_timeline</code>: Retrieve a host timeline from triage data.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| IAM Platform                  | <p><strong>Updated Paths</strong><br>- <code>GET /platform/iam/v1/role</code>: Clarified the response description; 403 responses now include named examples for insufficient-permissions and Instance Administrator privilege-escalation errors.<br>- <code>PUT /platform/iam/v1/scope/{entity\_type}/{entity\_id}</code>: Documented that <code>datasets\_rows</code> is available only on XSIAM tenants with the feature explicitly enabled — contact your account team to enable it. When enabled, this field is mandatory in every scope edit request; omitting it returns a 400 error.<br><br><strong>Updated Schemas</strong><br>- <code>DatasetsRowsScope</code>: Clarified that dataset row-level scoping is an XSIAM-only feature. When enabled, this field is required in all scope edit requests.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Issues APIs                   | <p><strong>Updated Paths</strong><br>- <code>POST /public\_api/v1/issue/search</code>: Added <code>include\_evidences</code> and <code>include\_actions</code> boolean request fields to control whether evidence and action objects are included in search results. Added compliance filter fields: <code>xdm.compliance.standard\_id</code>, <code>xdm.compliance.category\_id</code>, <code>xdm.compliance.control\_id</code>, <code>xdm.policy\_id</code>, <code>asset\_group\_names</code>, and <code>asset\_tags</code>.<br>- <code>POST /public\_api/v1/issue\_exceptions/</code>: Clarified exception creation behavior.<br><br><strong>Updated Schemas</strong><br>- <code>CreateIssueException</code>: Corrected field definitions for creating issue exceptions.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Managed Services              | <p><strong>Spec reorganization</strong><br>The Managed Services (MTH) endpoints moved from <code>managed-threat-detection-papi.yaml</code> to <code>managed-threat-detection-papi.json</code>. Existing operations are unchanged.<br><br><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/mth/child/get\_all\_reports</code>: Retrieve all reports for a child tenant.<br>- <code>POST /public\_api/v1/mth/child/get\_reports\_by\_statuses</code>: Retrieve reports filtered by status.<br><br><strong>Paths included</strong><br>- <code>POST /public\_api/v1/mth/child/add\_comment</code>, <code>/get\_comments</code>, <code>/get\_reports\_by\_source\_id</code>, <code>/get\_reports\_by\_incident\_id</code>, <code>/report/update/assign</code>, <code>/report/update/status</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Restore Distributions         | <p><strong>New spec published</strong><br>Restore Distributions Public API (<code>restore-distributions-papi.json</code>).<br><br><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/distributions/restore</code>: Restore a previously deleted agent installation package.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Unified Rules                 | <p><strong>New spec published</strong><br>Unified Rules API (<code>unified-rules-papi.json</code>) lets you manage linked Cloud Security and AppSec rule pairs through a single unified endpoint.<br><br><strong>Paths Added</strong><br>- <code>GET /public\_api/appsec/v1/unified-rules</code>: Returns a paginated list of all unified rule pairs.<br>- <code>POST /public\_api/appsec/v1/unified-rules</code>: Creates a linked Cloud Security (CSPM) and AppSec rule pair in a single operation.<br>- <code>GET /public\_api/appsec/v1/unified-rules/{ruleId}</code>: Returns the full details of a specific unified rule pair, including both the linked AppSec and Cloud Security (CSPM) rule objects.<br>- <code>PUT /public\_api/appsec/v1/unified-rules/{ruleId}</code>: Updates one or both rules in a unified rule pair in a single request.<br>- <code>DELETE /public\_api/appsec/v1/unified-rules/{ruleId}</code>: Deletes both the AppSec and Cloud Security rules in a unified rule pair in a single operation.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| UVEM                          | <p><strong>Updated Paths</strong><br>- <code>POST /vulnerability-management/v1/vulnerability-finding/search</code> and <code>POST /vulnerability-management/v1/vulnerability-finding/snapshot</code>: Corrected the documented paths to remove the trailing slash, matching live API behavior.<br>- Documented the <code>CVSS\_SEVERITY</code> and <code>EXPLOIT\_LEVEL</code> filter values available on vulnerability finding searches.<br>- Clarified the Bring Your Own Scanner (BYOS) import and job status endpoint descriptions.<br><br><strong>Updated Schemas</strong><br>- <code>FilterTriplet</code>: Renamed <code>field</code>, <code>operator</code>, and <code>value</code> to <code>SEARCH\_FIELD</code>, <code>SEARCH\_TYPE</code>, and <code>SEARCH\_VALUE</code> to match the live API.<br>- <code>FindingsSortObject</code>: Renamed <code>field</code> and <code>keyword</code> to <code>FIELD</code> and <code>ORDER</code> to match the live API.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Vulnerability Intelligence    | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

<br>

## Cortex XDR 5.1

| Product Name                  | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent Configurations          | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Application Security (AppSec) | <p><strong>Updated Schemas</strong><br>- <code>AppsecPolicyTriggersandActions</code>: Added <code>ciImage</code> and <code>imageRegistry</code> trigger configurations.<br>- <code>ConditionOperators</code>: Added <code>CONTAINS\_IN\_LIST</code>, <code>JSON\_WILDCARD</code>, <code>RANGE</code>, and <code>RELATIVE\_TIMESTAMP</code>.<br>- <code>CreateRequest</code>: Added <code>enabled</code>, <code>suggestionId</code>, and <code>userSbac</code>.<br>- <code>FindingType</code>: Updated enum values (e.g., <code>VULNERABILITY</code>, <code>CODE\_WEAKNESS</code>).<br>- <code>Integration</code>: Added <code>scanTypes</code>, <code>statusDetails</code>, and <code>tenantId</code>.<br>- <code>Policy</code>: Added <code>overrideIssueSeverity</code>, <code>scopeFields</code>, <code>suggestionHash</code>, and <code>suggestionId</code>.<br><br><strong>Schemas Added</strong><br>- <code>BillingErrorResponse</code>: Error schema for billing-related endpoints.<br>- <code>ConditionValue</code>: Structured value for range and key-value matching.<br>- <code>EmailOrigin</code>: Enum for user email sources (<code>API</code>, <code>GIT</code>).<br>- <code>IntegrationStatusDetails</code>: Detailed status for data source components.<br>- <code>RepositoryUser</code>: Detailed schema for repository contributors.<br>- <code>Transporter</code>: Configuration for secure communication with private data sources.<br>- <code>UnifiedAction</code>: Consolidated enum for all possible policy actions.<br><br><strong>Paths Added</strong><br>- <code>GET /public\_api/appsec/v1/billing/contributors</code>: Retrieve active contributors for billing.<br>- <code>POST /public\_api/appsec/v1/collectors/{collectorId}</code>: Upload 3rd party SARIF findings.<br><br><strong>Updated Paths</strong><br>- <code>POST /public\_api/appsec/v1/policies</code>: Detailed rules for finding types.<br><br><strong>Deprecated Paths</strong><br>The following Integrations API endpoints are deprecated:<br>- <code>GET /public\_api/appsec/v1/integrations</code><br>- <code>POST /public\_api/appsec/v1/integrations</code><br>- <code>GET /public\_api/appsec/v1/integrations/{integrationId}</code><br>- <code>PUT /public\_api/appsec/v1/integrations/{integrationId}</code><br>- <code>DELETE /public\_api/appsec/v1/integrations/{integrationId}</code><br><br><strong>Note</strong>: The deprecated endpoints will continue to function temporarily for backward compatibility. However, they will not receive further enhancements or updates. A formal sunset date will be announced in a future release.<br><br><strong>Replacement Paths</strong><br>The Integrations APIs are replaced with the following Data Source Instances API endpoints:<br>- <code>GET /public\_api/appsec/v1/data\_source\_instances</code><br>- <code>POST /public\_api/appsec/v1/data\_source\_instances</code><br>- <code>GET /public\_api/appsec/v1/data\_source\_instances/{id}</code><br>- <code>PUT /public\_api/appsec/v1/data\_source\_instances/{id}</code><br>- <code>DELETE /public\_api/appsec/v1/data\_source\_instances/{id}</code><br><br></p> |
| Asset Compliance              | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| CIEM                          | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Cloud Onboarding              | <p><strong>Updated Schemas</strong><br>- <code>CreateInstanceTemplateRequestData</code>: Added <code>ALIBABA\_CLOUD</code> and <code>gcp\_workspace</code>.<br>- <code>EditInstanceRequestData</code>: Added <code>ALIBABA\_CLOUD</code>, <code>connector\_name</code>, and <code>gcp\_workspace</code>.<br>- <code>InstanceAdditionalCapabilities</code>: Added <code>automation</code>, <code>automation\_log\_level</code>, and <code>kubernetes\_security</code>.<br><br><strong>Schemas Added</strong><br>- <code>AccountItem</code>: Added schema for cloud account items.<br>- <code>EditOutpostRequest</code>: Added schema for outpost edit requests.<br>- <code>EditOutpostRequestData</code>: Added schema for outpost edit request data.<br>- <code>InstanceListItem</code>: Added schema for cloud instance list items.<br><br><strong>Updated Paths</strong><br>- Terminology shift from "integration instance" to "cloud instance" across all endpoints.<br>- <code>POST /public\_api/v1/cloud\_onboarding/edit\_outpost</code>: Updated request/response schemas.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Compliance                    | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Cortex Cloud Platform         | <p><strong>Updated Schemas</strong><br>- <code>ErrorResponse</code>: Standardized error structure.<br><br><strong>Schemas Added</strong><br>- <code>CreateIssueException</code>: Schema for creating issue exceptions.<br>- <code>IssueException</code>: Full object representation for issue exceptions.<br>- <code>EditPreventionPolicyRequest</code>: Wrapper for prevention policy edit requests.<br>- <code>EditPreventionPolicyRequestData</code>: List of rule edits to apply.<br>- <code>PreventionPolicyEditParameters</code>: Parameters for editing prevention rules.<br>- <code>TargetFilter</code>: Structured condition tree for targeting endpoints.<br>- <code>SearchCondition</code>: Individual filter criteria.<br>- <code>SuccessResponse</code>: Simple boolean success indicator.<br><br><strong>Paths Added</strong><br>- <code>POST /public\_api/v1/issue\_exceptions/</code>: Create issue exceptions.<br>- <code>POST /public\_api/v1/issue\_exceptions/disable/</code>: Disable exceptions.<br>- <code>POST /public\_api/v1/issue\_exceptions/search/</code>: Search exceptions.<br>- <code>POST /public\_api/v1/policies/prevention/edit</code>: Atomic prevention rule edits.<br><br><strong>Updated Paths</strong><br>- <code>POST /public\_api/v1/distributions/create</code>: Added <code>caas\_embedded</code> package type.<br><br><strong>Spec reorganization</strong><br>The Issues, Cases, and Issue Exceptions endpoint groups have been relocated out of the platform spec into dedicated standalone specs (<code>issues-papi.json</code>, <code>cases-papi.json</code>). Operations and contracts are unchanged. See the new "Issues APIs" and "Cases APIs" entries above.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Cases APIs                    | <p><strong>Standalone spec published</strong><br>Cases endpoints now live in a dedicated standalone spec (<code>cases-papi.json</code>), separated from the platform spec for cleaner navigation. No contract changes — same operations, schemas, and components.<br><br><strong>Paths included</strong><br>- <code>POST /public\_api/v1/case/search</code>: Search and filter cases.<br>- <code>POST /public\_api/v1/case/update/{case-id}</code>: Update an existing case.<br>- <code>POST /public\_api/v1/case/artifacts/{case-id}/</code>: Retrieve case artifacts.<br>- <code>POST /public\_api/v1/case/schema</code>: Retrieve the case field schema.<br>- <code>POST /public\_api/v1/entries/get</code>: Retrieve case entries.<br>- <code>POST /public\_api/v1/entries/insert</code>: Add an entry to a case or alert War Room.<br><br><strong>Schema and description alignments</strong><br>- <code>Case</code>: Updated field types, descriptions, and required-field lists to align with current API behavior.<br>- <code>CaseArtifact</code>: Updated to reflect the current artifact structure.<br>- <code>UpdateCase</code>: Updated request schema for case updates.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Issues APIs                   | <p><strong>Standalone spec published</strong><br>Issues endpoints now live in a dedicated standalone spec (<code>issues-papi.json</code>), separated from the platform spec for cleaner navigation. No contract changes for the relocated endpoints.<br><br><strong>Paths included</strong><br>- <code>POST /public\_api/v1/issue</code>: Create a new issue.<br>- <code>POST /public\_api/v1/issue/{issue-id}</code>: Update an existing issue.<br>- <code>POST /public\_api/v1/issue/search</code>: Search and filter issues.<br>- <code>POST /public\_api/v1/issue/schema/</code>: Retrieve the dynamic issue field schema (trailing slash; aligned with current API behavior).<br>- <code>POST /public\_api/v1/issue\_exceptions/</code>: Create an issue exception.<br>- <code>POST /public\_api/v1/issue\_exceptions/disable/</code>: Disable an issue exception.<br>- <code>POST /public\_api/v1/issue\_exceptions/search/</code>: Search issue exceptions.<br><br><strong>Schema and description alignments</strong><br>The <code>Issue</code> schema and <code>issue/search</code> response wrapper have been updated to reflect current API behavior:<br>- <code>Issue</code>: Added 11 fields previously missing from the documented schema: <code>action\_status</code>, <code>agentic\_assistant\_id</code>, <code>agentic\_response\_conversation\_id</code>, <code>agentic\_response\_status</code>, <code>asset\_cloud\_account\_names</code>, <code>asset\_external\_provider\_ids</code>, <code>case\_ids</code>, <code>exception\_expiration</code>, <code>exception\_ids</code>, <code>initial\_evidence</code>, <code>is\_excepted</code>.<br>- <code>issue/search</code> response wrapper: Renamed <code>total\_count → TOTAL\_COUNT</code>, <code>result\_count → FILTER\_COUNT</code>, and <code>issues → DATA</code> to match current API behavior.<br>- <code>issue/schema/</code> response wrapper: Updated from <code>reply.data</code> to <code>reply.DATA</code>.<br>- <code>IssueSchemaField.data\_type</code> example: Expanded to include <code>TEXT</code>, <code>BIGINT</code>, <code>INT</code>, <code>FLOAT</code>, <code>BOOLEAN</code>, <code>TIMESTAMP</code>, <code>ENUM</code>, <code>JSON</code>, <code>COMPLEX</code>, and <code>ARRAY</code> representative values returned by the API.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| CSPM Policies                 | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| CWP                           | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Detection Rules               | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| IAM Platform                  | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| UVEM                          | <p><strong>Bring Your Own Scanner (BYOS)</strong><br>Import vulnerability findings from external scanners into Cortex vulnerability management.<br><br><strong>Paths Added</strong><br>- <code>POST /public\_api/vulnerability-management/v1/external-scans/assets</code>: Submit assets and CVE findings from a third-party scanner; returns a <code>job\_id</code> for async status polling.<br>- <code>GET /public\_api/vulnerability-management/v1/external-scans/assets/jobs/{job\_id}</code>: Poll the status of a BYOS import job.<br><br><strong>Schemas Added</strong><br>- <code>VulnerableAssetImportRequest</code>, <code>VulnerableAssetImportResponse</code>, <code>ImportJobResponse</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Vulnerability Intelligence    | <p><strong>Updated Schemas</strong><br>- <code>VulnerabilityFinding</code>: Comprehensive schema for CVE/asset records.<br><br><strong>Schemas Added</strong><br>- <code>FilterBlock</code>: Logical filter block supporting AND/OR connectors.<br>- <code>FilterTriplet</code>: Individual filter condition.<br>- <code>FindingsErrorResponse</code>: Standardized error response.<br>- <code>FindingsSortObject</code>: Sort criteria for findings.<br>- <code>GetVulnerabilityFindingByIdResponse</code>: Response for single finding lookups.<br>- <code>GetVulnerabilityFindingsRequest</code>: Request for paginated searches.<br>- <code>GetVulnerabilityFindingsResponse</code>: Response for paginated searches.<br>- <code>GetVulnerabilityFindingsSnapshotRequest</code>: Parameters for bulk snapshot exports.<br>- <code>TimeframeAbsolute</code>: Absolute time range schema.<br><br><strong>Paths Added</strong><br>- <code>POST /vulnerability-management/v1/vulnerability-finding/search/</code>: Paginated search.<br>- <code>POST /vulnerability-management/v1/vulnerability-finding/snapshot/</code>: Bulk export (NDJSON).<br>- <code>POST /vulnerability-management/v1/vulnerability-finding/{platform\_id}</code>: Get finding by ID.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

<br>

## Cortex XDR 5.0

| Product Name                           | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application Security                   | <p><strong>Schemas Added</strong><br>- <code>ApplicationAssetSelectionFilter</code>: Defines filter criteria to dynamically select application assets.<br>- <code>ApplicationAssetSelectionFilterValues</code>: Container for filter values used to match application assets (orgUrl, repositoryId, projectUrl, etc.).<br>- <code>ManualAndRunCriteriaApplicationAssetSelectionFilter</code>: Specific filter for manual and run criteria.<br>- <code>ApplicationMetadataCode</code>: Metadata for code-based assets, including business owner and criticality.<br>- <code>BusinessOwnerMetaData</code>: Enum for business owner types (<code>organizationOwner</code>, <code>projectOwner</code>, etc.).<br>- <code>CodeCriteriaConfig</code>: Configuration for code-based criteria, including unification settings.<br>- <code>CriteriaDTOCode</code>: Detailed data transfer object for code criteria.<br>- <code>IACSecurity</code>: Configuration for Infrastructure as Code (IaC) security scanners.<br>- <code>secretsSecurity</code>: Configuration for secrets security scanners.<br>- <code>CriteriaType.Code</code>: Enum for criteria types.<br><br><strong>Updated Schemas</strong><br>- <code>ApplicationAssetSelection</code>: Updated description and properties.<br>- <code>ApplicationConfigurationSettings</code>: Added <code>sla</code> (Service Level Agreement) configurations for different severity levels (CRITICAL, HIGH, MEDIUM, LOW).<br>- <code>CreateApplicationRequest</code>: Updated required fields and added detailed descriptions for owners (DevOps, Dev, Product Manager).<br>- <code>DetectionRule</code>: Extensive updates to properties including <code>detectionMethod</code>, <code>frameworks</code>, and <code>scanner</code>.<br>- <code>ExtendedFields</code>: Added <code>unifyAcrossProviders</code> and <code>unifyWithinProvider</code> flags.<br>- <code>FrameworkName</code>: Expanded enum with many new values (e.g., <code>CI\_CD\_GITHUB\_REPO</code>, <code>TERRAFORMPLAN</code>, <code>OPENAPI</code>).<br><br><strong>Paths Added</strong><br>- None<br><br><strong>Updated Paths</strong><br>- GET <code>/public\_api/appsec/v1/application</code>: Updated descriptions and added mandatory <code>Authorization</code> and <code>x-xdr-auth-id</code> headers.<br>- POST <code>/public\_api/appsec/v1/application</code>: Updated descriptions and added mandatory <code>Authorization</code> and <code>x-xdr-auth-id</code> headers.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Cloud Onboarding                       | <p><strong>Updated Schemas</strong><br>- <code>CreateInstanceTemplateRequestData</code>: Added <code>cloud\_partition</code> field (COMMERCIAL/GOV) to <code>request\_data</code>.<br>- <code>CreateOutpostTemplateRequestData</code>: Added <code>cloud\_partition</code> field (COMMERCIAL/GOV) to <code>request\_data</code>.<br>- <code>EditInstanceRequestData</code>: Added <code>cloud\_partition</code> field (COMMERCIAL/GOV) to <code>request\_data</code>.<br>- <code>ListCloudProviderRegionsRequestData</code>: Added <code>cloud\_partition</code> field (COMMERCIAL/GOV) to <code>request\_data</code>.<br>- <code>ListCloudProviderRegionsResponse</code>: Changed <code>reply</code> type from <code>object</code> to <code>array</code> and updated its items to include <code>name</code>, <code>value</code>, and <code>type</code>.<br><br><strong>Schemas Added</strong><br>- None<br><br><strong>Paths Added</strong><br>- None<br><br><strong>Updated Paths</strong><br>- POST <code>/public\_api/v1/cloud\_onboarding/create\_instance\_template</code>: Updated request body examples to include <code>cloud\_partition</code>.<br>- POST <code>/public\_api/v1/cloud\_onboarding/edit\_instance</code>: Updated request body examples to include <code>cloud\_partition</code>.<br>- POST <code>/public\_api/v1/cloud\_onboarding/get\_azure\_approved\_tenants</code>: Added <code>cloud\_parition</code> to the request body schema.<br>- POST <code>/public\_api/v1/cloud\_onboarding/get\_instance\_details</code>: Updated summary from "Get integration instance details" to "Get cloud instance details" and updated response examples to include <code>cloud\_partition</code>.<br><br><strong>Note</strong>: The primary change in this version is the introduction of the <code>cloud\_partition</code> parameter across onboarding APIs to support both <code>COMMERCIAL</code> and <code>GOV</code> (government) cloud environments.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Compliance                             | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Cortex Cloud Platform                  | <p>The following new APIs have been added under Endpoint Management:<br>- <code>POST /public\_api/v1/distributions/get\_distributions</code><br>- <code>POST /public\_api/v1/endpoints/get\_profiles</code><br>- <code>POST /public\_api/v1/legacy\_exceptions/get\_modules</code><br>- <code>POST /public\_api/v1/legacy\_exceptions/fetch</code><br>- <code>POST /public\_api/v1/legacy\_exceptions/add</code><br>- <code>POST /public\_api/v1/legacy\_exceptions/edit</code><br>- <code>POST /public\_api/v1/legacy\_exceptions/delete</code><br><br><strong>Updated Paths</strong><br>- POST /public\_api/v1/distributions/create: Updated serverless support</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Cloud CIEM                             | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Compute(CWP)                           | <p>The following new APIs have been added:<br>- <code>POST /public\_api/v1/cwp/registry\_onboarding/instances</code><br>- <code>GET /public\_api/v1/cwp/registry\_onboarding/instances/{connectorID}</code><br>- <code>PUT /public\_api/v1/cwp/registry\_onboarding/instances/{connectorID}</code><br>- <code>DELETE /public\_api/v1/cwp/registry\_onboarding/instances/{connectorID}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Detection Rules Management             | <p>The following new APIs have been added:<br>- <code>POST /public\_api/v1/rule</code><br>- <code>POST /public\_api/v1/rule/search</code><br>- <code>GET /public\_api/v1/rule/{id}</code><br>- <code>PATCH /public\_api/v1/rule/{id}</code><br>- <code>DELETE /public\_api/v1/rule/{id}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Disable Prevention Rule                | <p>The following new APIs have been added:<br>- <code>POST /public\_api/v1/disable\_prevention/get\_modules</code><br>- <code>POST /public\_api/v1/disable\_prevention/fetch</code><br>- <code>POST /public\_api/v1/disable\_prevention/edit</code><br>- <code>POST /public\_api/v1/disable\_prevention/add</code><br>- <code>POST /public\_api/v1/disable\_prevention/delete</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Disable Injection and Prevention Rules | <p>The following new APIs have been added:<br>- <code>POST /public\_api/v1/disable\_injection\_prevention\_rules/fetch</code><br>- <code>POST /public\_api/v1/disable\_injection\_prevention\_rules/add</code><br>- <code>POST /public\_api/v1/disable\_injection\_prevention\_rules/disable</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| DSPM                                   | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| IAM Platform                           | <p><strong>Schemas Added</strong><br>- <code>AssetGroup</code><br>- <code>AssetsScope</code><br>- <code>AssetsScopeRequest</code><br>- <code>CasesIssuesScope</code><br>- <code>CasesIssuesScopeRequest</code><br>- <code>DatasetFilter</code><br>- <code>DatasetsRowsScope</code><br>- <code>EndpointGroupsScope</code><br>- <code>EndpointGroupsScopeRequest</code><br>- <code>EndpointTagsScope</code><br>- <code>EndpointTagsScopeRequest</code><br>- <code>EndpointsScope</code><br>- <code>EndpointsScopeRequest</code><br>- <code>Role</code><br>- <code>Tag</code><br><br><strong>Updated Schemas</strong><br>- <code>UnauthorizedImproperPermissions</code>: Updated example and properties for the <code>reply</code> object; added <code>data</code> and <code>reply</code> to required fields.<br>- <code>ApiKeyEditRequest</code>: Updated descriptions for <code>comment</code>, <code>roles</code>, and <code>security\_level</code>.<br>- <code>RoleCreateRequest</code>: Updated description for <code>request\_data</code>.<br>- <code>ScopeEditRequest</code>: Added <code>request\_data</code> properties including <code>assets</code>, <code>cases\_issues</code>, <code>datasets\_rows</code>, <code>endpoints</code>, <code>tagless\_scope</code>, and <code>tags\_scope</code>.<br>- <code>UserEditRequest</code>: Updated descriptions for <code>is\_hidden</code>, <code>phone\_number</code>, <code>role\_id</code>, <code>status</code>, <code>user\_first\_name</code>, <code>user\_groups</code>, and <code>user\_last\_name</code>.<br>- <code>UserGroupCreateRequest</code>: Updated descriptions for <code>description</code>, <code>group\_name</code>, <code>idp\_groups</code>, <code>nested\_group\_ids</code>, <code>role\_id</code>, and <code>users</code>.<br>- <code>UserGroupEditRequest</code>: Updated descriptions for <code>description</code>, <code>group\_name</code>, <code>idp\_groups</code>, <code>nested\_group\_ids</code>, <code>role\_id</code>, and <code>users</code>.<br><br><strong>Paths Added</strong><br>- None<br><br><strong>Updated Paths</strong><br>- <code>/platform/iam/v1/api-key/{api\_key\_id}</code>: Updated GET response schema and PUT request body description.<br>- <code>/platform/iam/v1/role</code>: Updated GET response schema (now uses <code>Role</code> schema) and POST request body description.<br>- <code>/platform/iam/v1/role/permission-config</code>: Updated GET response schema.<br>- <code>/platform/iam/v1/scope/{entity\_type}/{entity\_id}</code>: Updated GET response schema and PUT request body description.<br>- <code>/platform/iam/v1/user</code>: Updated GET response schema.<br>- <code>/platform/iam/v1/user-group</code>: Updated GET response schema and POST request body description.<br>- <code>/platform/iam/v1/user-group/{group\_id}</code>: Updated GET response schema and PUT request body description.</p> |
| Managed Services                       | <p>The following new APIs have been added:<br>- <code>POST /public\_api/v1/mth/child/add\_comment</code><br>- <code>POST /public\_api/v1/mth/child/get\_comments</code><br>- <code>POST /public\_api/v1/mth/child/report/update/assign</code><br>- <code>POST /public\_api/v1/mth/child/get\_reports\_by\_source\_id</code><br>- <code>POST /public\_api/v1/mth/child/get\_reports\_by\_incident\_id</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Platform External Application          | <p>The following new APIs have been added:<br>- <code>GET /platform/integration/v1/external-application</code><br>- <code>GET /platform/integration/v1/external-application/{application\_id}</code><br>- <code>DELETE /platform/integration/v1/external-application/{application\_type}/id/{application\_id}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Platform Notifications                 | <p>The following new APIs have been added:<br>- <code>GET /platform/notifications/v1/list-rules</code><br>- <code>POST /platform/notifications/v1/rule</code><br>- <code>GET /platform/notifications/v1/rule/{rule\_uuid}</code><br>- <code>PUT /platform/notifications/v1/update-rule-status/{rule\_uuid}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Trusted Images                         | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| UVEM                                   | <p><strong>Schemas Added</strong><br>- <code>ScanRequest</code>: Request model for triggering a vulnerability scan.<br>- <code>ScanResponse</code>: Response model for scan trigger operation.<br>- <code>ScannerType</code>: Enum for vulnerability scanner types (<code>CORTEX\_NETWORK\_SCANNER</code>, <code>CORTEX\_XDR\_AGENT</code>, <code>CORTEX\_XDR\_AGENTLESS</code>).<br><br><strong>Updated Schemas</strong><br>- <code>CreatePolicy</code>: Refined property definitions for <code>policy\_type</code>, <code>severity</code>, and <code>status</code> using <code>allOf</code>.<br>- <code>Filter-Input</code>: Refined <code>paging</code> property definition using <code>allOf</code>.<br>- <code>PolicyView</code>: Refined <code>POLICY\_TYPE</code> and <code>SEVERITY</code> property definitions using <code>allOf</code>.<br><br><strong>Paths Added</strong><br>- POST <code>/public\_api/vulnerability-management/v1/scan</code><br><br><strong>Updated Paths</strong><br>- <code>/public\_api/uvm\_public/v1/create\_policy</code>: Added description to <code>requestBody</code>.<br>- <code>/public\_api/uvm\_public/v1/list\_policies</code>: Added description to <code>requestBody</code>.<br>- <code>/public\_api/uvm\_public/v1/update\_policy/{id}</code>: Added description to <code>requestBody</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Vulnerability                          | No Changes in this release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xdr-5-api/api-release-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
