DOCS-38: Update API reference

[jeff-matthews]

Summary

This pull request (PR) updates the OpenAPI spec that we use to generate the REST API reference for the v9.7.0 release.

Aside from updates to request and response properties for existing paths, the following significant updates were made.

New endpoints

Mostly related to the collector support bundles, notification system, and protected asset scores:

• GET /api/v2/alert-attempts
• POST /api/v2/alert-attempts/retry
• GET /api/v2/alert-event-types
• GET /api/v2/alert-events
• GET /api/v2/alert-events/{alert_event_id}
• GET /api/v2/alert-webhooks
• POST /api/v2/alert-webhooks
• DELETE /api/v2/alert-webhooks/{alert_webhook_id}
• GET /api/v2/alert-webhooks/{alert_webhook_id}
• PATCH /api/v2/alert-webhooks/{alert_webhook_id}
• POST /api/v2/alert-webhooks/{alert_webhook_id}/rotate-secret
• POST /api/v2/alert-webhooks/{alert_webhook_id}/test
• GET /api/v2/alerts
• POST /api/v2/alerts
• DELETE /api/v2/alerts/{alert_id}
• GET /api/v2/alerts/{alert_id}
• PATCH /api/v2/alerts/{alert_id}
• GET /api/v2/asset-scores/zone-protected-asset-score
• POST /api/v2/clients/management/artifacts
• GET /api/v2/clients/management/artifacts/{artifact_id}
• POST /api/v2/clients/management/artifacts/{artifact_id}/complete
• POST /api/v2/clients/management/artifacts/{artifact_id}/parts/{part_number}
• GET /api/v2/clients/management/available
• POST /api/v2/clients/management/end
• POST /api/v2/clients/management/start
• DELETE /api/v2/clients/{client_id}/artifacts/{artifact_id}
• GET /api/v2/clients/{client_id}/artifacts/{artifact_id}
• GET /api/v2/clients/{client_id}/artifacts/{artifact_id}/download
• POST /api/v2/clients/{client_id}/artifacts/{artifact_id}/download-url
• POST /api/v2/clients/{client_id}/management

See attachment for oasdiff:
openapi_change.log

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Essentials

Run ID: a5761615-aaf7-442b-8e60-06e79148eda6

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}