Keep the OpenAPI spec in sync with the API automatically

[AlistairNorman]

Desired Behavior

Automated API documentation for both API users and agents.

[jarednorman]

Our current OpenAPI docs are out of date and there's no automation. We should make sure we find a process or setup for keeping them synchronized with the actual API.