Skip to content

Links to OpenAPI schemas out of date - all links receive 404s #2425

@harryjhornby

Description

@harryjhornby

openapi-typescript version

7.9.1

Node.js version

20.14.0

OS + version

macOS 15.6.1

Description

Following the basic setup steps from the website and readme, I immediately hit this error:

 client git:(hh/openapi-ts-generation) ✗ npx openapi-typescript ../openapi-spec.yaml -o ./schema.d.ts
✨ openapi-typescript 7.9.1
 ✘  Can't resolve $ref: Failed to load https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.yaml: 404 Not Found at #/paths/~1open-api~1spec/get/responses/200/content/text~1yaml/schema
 ✘  Can't resolve $ref: Failed to load https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json: 404 Not Found at #/paths/~1open-api~1spec/get/responses/200/content/application~1json/schema
 ✘  Can't resolve $ref: Failed to load https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.yaml: 404 Not Found at #/paths/~1open-api~1spec~1{serviceName}/get/responses/200/content/text~1yaml/schema
 ✘  Can't resolve $ref: Failed to load https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json: 404 Not Found at #/paths/~1open-api~1spec~1{serviceName}/get/responses/200/content/application~1json/schema

These links target the main branch in the repo so any changes in main immediately affect this library. https://github.com/OAI/OpenAPI-Specification

You can see that on the current version this entire folder has been deleted.

Reproduction

Just follow the getting started steps: https://openapi-ts.dev/introduction#basic-usage

Expected result

Links to schemas are valid

Required

  • My OpenAPI schema is valid and passes the Redocly validator (npx @redocly/cli@latest lint)

Extra

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingopenapi-tsRelevant to the openapi-typescript library

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions