Authorization header with no Bearer prefix. Create a key on your account at app.swaggerhub.com under Settings, then API Key. There is no per-account host and no second credential.
Things to know before you call:
- Every spec is addressed by
owner/api/version, and the owner and name are case-sensitive. Each segment is URL-encoded, so a version likefeature/branchsurvives. GET /apisandGET /domainsanswer a 303 to/specs, sospecs.listis the listing route this plugin uses.apis.listreads one owner’s APIs.- Saving takes the definition itself as the body, not a wrapper.
format: 'yaml'is the default;format: 'json'sends the JSON media type. - Defining the version twice. For OpenAPI and AsyncAPI the version is read from
info.version, soversionis optional on save. GraphQL and MCP need it. - A save answers 409 on a published version unless
forceis set, and a save replies with no body, so the plugin reports what it wrote. specs.validatesaves nothing. It is the structural check to run before a save, and it returns findings with line and column positions.comments.listanswers a bare array, and a 204 when the version has no comments. A 204 reads as{ comments: [], empty: true }.apis.compareposts a definition and answers a bare array of differences. Nothing is stored.projects.updatereplaces the project, so a collection left out is cleared. The plugin always sends all three collections.
- 44 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the SwaggerHub API key before the first call: More: API Key
pnpm corsair setup --plugin=swaggerhub --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List API specsWhat’s next
API reference
Every
swaggerhub.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.