API documentation rewrite

Improvement

We've rewritten our API documentation in OpenAPI 3.1 spec and added additional descriptions/examples to improve the experience of implementing our API.

Feedback on our API documentation is always welcome!