New Recipe - Cove - Get Executive Summary Reports

Automate the bulk download of Cove Data Protection Executive Summary PDF reports for all sub-partners under a Reseller or ServiceOrganization account.

https://developer.n-able.com/n-able-cove/recipes/cove-download-exec-summary-pdf-report

The script authenticates to the Backup.Management API, enumerates all ServiceOrganization-level child partners, queries the Report Manager REST API for existing reports for the configured period, triggers generation for any partners that do not yet have a report (capped by -MaxGenerate), polls until all in-progress reports reach a terminal state, and downloads all Ready-state PDFs to a local folder.

Parameters

Parameter	Default	Description
`-Since`	First day of prior month	Report period (month) to query
`-ExportPath`	`.\Exec_Summary_Reports_<yyyy-MM>\`	Root folder for downloaded PDFs
`-MaxGenerate`	`6`	Cap on generation requests per run (`0` = unlimited)
`-ClearCredentials`	—	Wipe and re-enter stored API credentials

REST Endpoints Used

POST https://api.backup.management/jsonapi — Login, GetPartnerInfo, EnumerateChildPartners
GET https://api.backup.management/report-manager/partners/{nri}/subpartners/reports/{iso8601}
POST https://api.backup.management/report-manager/partners/{nri}/reports/{iso8601}/generate
POST https://api.backup.management/notifications-publisher-api/negotiate
POST https://api.backup.management/downloads-proxy-api/files/{fileId}/download-tokens
GET https://downloads-proxy-api.cloudbackup.management/downloads?token={token}