openapi: rebuild OpenAPI spec

Signed-off-by: Hank Donnay <[email protected]>

Author: hdonnay

.gitattributes

@@ -1,2 +1,3 @@
 cmd/build.go export-subst
 *.go diff=golang
+Documentation/reference/api.md linguist-generated

Documentation/howto/api.md

@@ -1,6 +1,6 @@
 # API Definition
 
-Clair provides its API definition via an OpenAPI specification. You can view our OpenAPI spec [here](https://raw.githubusercontent.com/quay/clair/main/openapi.yaml)
+Clair provides its API definition via an OpenAPI specification. You can view our OpenAPI spec [here][openapi_v1].
 
 The OpenAPI spec can be used in a variety of ways.
 * Generating http clients for your application
@@ -11,3 +11,5 @@ The OpenAPI spec can be used in a variety of ways.
 See [Testing Clair](./testing.md) to learn how the local dev tooling starts a local swagger editor. This is handy for making changes to the spec in real time.
 
 See [API Reference](../reference/api.md) for a markdown rendered API reference.
+
+[openapi_v1]: https://github.com/quay/clair/tree/main/httptransport/api/v1