Skip to main content
Use SwaggerHub through Corsair: one client, typed API calls. SwaggerHub authenticates with one API key, sent in the 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 like feature/branch survives.
  • GET /apis and GET /domains answer a 303 to /specs, so specs.list is the listing route this plugin uses. apis.list reads 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, so version is optional on save. GraphQL and MCP need it.
  • A save answers 409 on a published version unless force is set, and a save replies with no body, so the plugin reports what it wrote.
  • specs.validate saves nothing. It is the structural check to run before a save, and it returns findings with line and column positions.
  • comments.list answers a bare array, and a 204 when the version has no comments. A 204 reads as { comments: [], empty: true }.
  • apis.compare posts a definition and answers a bare array of differences. Nothing is stored.
  • projects.update replaces the project, so a collection left out is cleared. The plugin always sends all three collections.
What you get:
  • 44 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

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 specs
Save a definition
See the full list on the API page.

What’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.