Generate REST API docs

[pavithraes]

Addresses #561
Closes #754

Description

This pull request:

• a
• b
• c

Pull request checklist

• Did you test this change locally?
• Did you update the documentation (if required)?
• Did you add/update relevant tests for this change (if required)?

Additional information

TODO before merging

• Write a gh action to make sure openapi.json and the rest api docs are automatically updates on each release.

[netlify]

❌ Deploy Preview for kaleidoscopic-dango-0cf31d failed.

Name	Link
🔨 Latest commit	915beaa
🔍 Latest deploy log	https://app.netlify.com/sites/kaleidoscopic-dango-0cf31d/deploys/6597e7fc31d21100084908aa

[pavithraes]

The plugin we're using here is in the process of adding support for Docusaurus v3, ref: https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/issues/654

[pavithraes]

Closing this because we have a temporary solution in place, we can open a fresh PR later when unblocked. :)