feat: improve openapi spec #2110

Job	Run time
Run OIDC conformity tests	8m 11s
Generate SDKs	3m 39s
Run HSM tests	5m 30s
Run end-to-end tests (memory)	4m 56s
Run tests and lints	47s
Run end-to-end tests (memory, --jwt)	5m 11s
Run end-to-end tests (postgres)	5m 2s
Run end-to-end tests (postgres, --jwt)	5m 4s
Run end-to-end tests (mysql)	5m 21s
Run end-to-end tests (mysql, --jwt)	5m 10s
Run end-to-end tests (cockroach)	5m 24s
Run end-to-end tests (cockroach, --jwt)	5m 31s
Build CLI docs	0s
Generate changelog	1s
Generate release	1s
Draft newsletter	1s
Release SDKs	1s
Render version schema	1s
Send newsletter	1s
Pending approval Slack notification	1s
	59m 53s

Provide feedback