Skip to content

[docs] Fix OpenAPI 3 validation errors in rest catalog spec#7766

Open
ArnavBalyan wants to merge 1 commit intoapache:masterfrom
ArnavBalyan:arnavb/fix-openapi-spec
Open

[docs] Fix OpenAPI 3 validation errors in rest catalog spec#7766
ArnavBalyan wants to merge 1 commit intoapache:masterfrom
ArnavBalyan:arnavb/fix-openapi-spec

Conversation

@ArnavBalyan
Copy link
Copy Markdown
Member

@ArnavBalyan ArnavBalyan commented May 3, 2026

Purpose

  • The rest catalog OpenAPI spec at docs/static/rest-catalog-open-api.yaml is not OpenAPI 3 compliant has 32 errors. Swagger UI allows this, but openapi-generator-cli fails on this.
  • Several named ErrorResponse components have schema.$ref pointing to another response object instead of a schema. The databaseNamePattern parameter is declared in: path but is a sql like filter, so it has to be in: query.
  • Fixes: [Bug] OpenApi generation fails with errors #7760

Tests

  • Validated locally with openapi-generator-cli 7.22.0. Before the change the same command reports 32 errors.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] OpenApi generation fails with errors

1 participant