Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

business-messaging-api_v23.0.yaml is not valid

Open Beginner friendly
#4 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Quiet
Tech stack
openapi
Domain
api

Research direction

Start with business-messaging-api_v23.0.yaml and inspect the components.parameterGroups declaration reported by both validation commands. Reproduce the swagger-spec-validator and OpenAPI Generator checks, then confirm the specification passes validation and TypeScript Axios generation without the unexpected-attribute error.

Written by the indexing model from the issue text.

Description

The OpenAPI spec seems to not be fully valid. When we try and validate the Swagger Doc using the following command, we see it returning business-messaging-api_v23.0.yaml: attribute components.parameterGroups is unexpected

docker run --rm node:26-alpine sh -c "apk add wget && npm i -g swagger-spec-validator && wget https://raw.githubusercontent.com/facebook/openapi/main/business-messaging-api_v23.0.yaml && swagger-spec-validator business-messaging-api_v23.0.yaml"

When we try and to a TS codegen from it, it also fails

docker run --rm node:26-alpine sh -c "apk add --no-cache openjdk17-jdk && npm install -g openapi-typescript @openapitools/openapi-generator-cli && npx @openapitools/openapi-generator-cli generate -i https://raw.githubusercontent.com/facebook/openapi/main/business-messaging-api_v23.0.yaml -g typescript-axios -o /tmp/"

returns

Exception in thread "main" org.openapitools.codegen.SpecValidationException: There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
 | Error count: 1, Warning count: 105
Errors: 
        -attribute components.parameterGroups is unexpected
Warnings: 
        -attribute components.parameterGroups is unexpected

        at org.openapitools.codegen.config.CodegenConfigurator.toContext(CodegenConfigurator.java:718)
        at org.openapitools.codegen.config.CodegenConfigurator.toClientOptInput(CodegenConfigurator.java:745)
        at org.openapitools.codegen.cmd.Generate.execute(Generate.java:527)
        at org.openapitools.codegen.cmd.OpenApiGeneratorCommand.run(OpenApiGeneratorCommand.java:32)
        at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:66)
Dominant language
No language data
Stars
179
Forks
61
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from facebook/openapi

All issues in facebook/openapi

Similar issues

More Backend & API Design issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.