fix(netbox): correct security scheme naming and servers/paths structure - #45
Merged
michaelelrom merged 3 commits intoJul 27, 2026
Merged
Conversation
…-3.7.8 Also drops the anachronistic Bearer/v2 token mention from the scheme description — v2 tokens weren't introduced until NetBox v4.5.
…tbox-latest Reorders the token auth description to lead with Bearer <key>.<token> (v2, current) and flag Token <token> (v1) as deprecated as of NetBox v4.6, matching NetBox's own current documentation.
…tput
netbox-latest.json combined a "https://{host}/api" server URL with paths
that already carried an /api/ prefix, producing a broken doubled
"/api/api/..." when resolved. Verified against a live NetBox instance
(demo.netbox.dev, v4.6.5) that NetBox emits an empty server url and
bakes /api/ into every path.
Updated both netbox-latest.json and netbox-3.7.8.json to match that
convention: servers[0].url = "" and /api/ prefixed onto every REST
path (netbox-4.1.json already followed this pattern).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
bearerAuth(should betokenAuth, matching NetBox's own OpenAPI schema at every version); also dropped an anachronisticBearer/v2 token mention since v2 tokens didn't exist until NetBox v4.5.Bearer <key>.<token>(v2) as the current standard and flags legacyToken <token>(v1) as deprecated as of NetBox v4.6, matching NetBox's own current docs.servers[0].urlwashttps://{host}/apiwhile every path already carried an/api/prefix, producing a broken doubled/api/api/...when resolved.servers/pathsto the same convention used by NetBox's real/api/schema/output (empty serverurl,/api/baked into paths) — verified live againstdemo.netbox.dev(v4.6.5).Test plan
/api/api/)