Updated API documentation, PG-4988

[lachiebol]

Description

To have a look at what it looks like in swagger
ddev matomo:console openapidocs:generate-spec-file --plugin CustomAlerts --not-dry-run --add-annotations

Then copy json result into: https://editor.swagger.io/

Issue No

Steps to Replicate the Issue

Checklist

• [✖] Tested locally or on demo2/demo3?
• [NA] New test case added/updated?
• [NA] Are all newly added texts included via translation?
• [NA] Are text sanitized properly? (Eg use of v-text v/s v-html for vue)
• [✔] Version bumped?
• [✔] I have understood, reviewed, and tested all AI outputs before use
• [✔] All AI instructions respect security, IP, and privacy rules

[AltamashShaikh]

@lachiebol FYI, even PHPStorm provides the preview, when viewing spec file

[lachiebol]

@AltamashShaikh Thanks for letting me know 😄 I wasn't aware, something might be missing in my setup as that doesn't show for me.