chore: fix swagger docs for consistency pref #406

	name: review
	on:
	pull_request:
	branches:
	- main
	- feat/*

	permissions:
	contents: read

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f # v4.1.3
	with:
	fetch-depth: 0
	- uses: bufbuild/buf-setup-action@35c243d7f2a909b1d4e40399b348a7fdab27d78d # v1.34.0
	- uses: bufbuild/buf-lint-action@06f9dd823d873146471cfaaf108a993fe00e5325 # v1.1.1
	- uses: bufbuild/buf-breaking-action@c57b3d842a5c3f3b454756ef65305a50a587c5ba # v1.1.4
	with:
	# The 'main' branch of the GitHub repository that defines the module.
	against: "https://github.com/${GITHUB_REPOSITORY}.git#branch=${GITHUB_BASE_REF}"
	- run: buf format -d --exit-code

	diff-openapi:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f # v4.1.3
	with:
	fetch-depth: 0
	- uses: bufbuild/buf-setup-action@35c243d7f2a909b1d4e40399b348a7fdab27d78d # v1.34.0
	- name: "Generate OpenAPI & Diff"
	run: \|
	make all
	git diff --text --exit-code docs/openapiv2/apidocs.swagger.json proto/*/.go

	validate-openapi:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f # v4.1.3
	with:
	fetch-depth: 0
	- uses: char0n/swagger-editor-validate@65266f9d3147e446b96af879fd317ce6079529ea # v1.3.2
	with:
	definition-file: ./docs/openapiv2/apidocs.swagger.json

Provide feedback