We need a GHA workflow that automatically updates the REST API docs from the upstream source of truth.
Per @djgrove there is a public API point that serves the spec, so we should do a nightly update, ensure that we have some versioning to know when the last update ran (similar to what we did with the ESC schema docs), but that still does not create unnecessary churn if there are no actual changes in the API spec.
We need a GHA workflow that automatically updates the REST API docs from the upstream source of truth.
Per @djgrove there is a public API point that serves the spec, so we should do a nightly update, ensure that we have some versioning to know when the last update ran (similar to what we did with the ESC schema docs), but that still does not create unnecessary churn if there are no actual changes in the API spec.