Provider migration

Migrate from SwaggerHub to Sourced

SwaggerHub is useful for collaborative OpenAPI design. Sourced fits when the same spec needs to become customer-ready docs, SDK previews, llms.txt, and launch checks. On this page: what to scan in your SwaggerHub setup, the migration checks Sourced runs, and a preview of the generated SDK and docs you would get.

Unlimited previews. No credit card required.

  • InputsExisting setup
  • OutputsSDKs + docs preview
  • ReportLaunch checklist
  • RiskReversible plan

01Checks

What to check

01

SwaggerHub projects and domains need a clean export plan.

02

Hosted reference URLs and anchors need redirect coverage.

03

Examples and auth metadata need to be present in OpenAPI before generation.

04

SDK generation and publishing need their own readiness checks.

02Checks

Migration checklist

01

Export the canonical OpenAPI definition from SwaggerHub and confirm it is the same version your public docs serve.

02

List every SwaggerHub docs URL, version URL, and custom-domain path before changing DNS.

03

Move examples, auth schemes, server URLs, and error schemas into the OpenAPI source so generated docs and SDKs stay aligned.

04

Generate a Sourced preview and compare operation names, models, auth setup, and examples before redirecting customers.

05

Keep SwaggerHub available during the first Sourced preview cycle so product and engineering can compare output side by side.

03Details

Why Sourced fits

01

Sourced turns the OpenAPI spec into docs plus TypeScript and Python SDK previews, not just hosted API reference pages.

02

The migration report shows what is ready, broken, or needs review before any publishing step.

03

llms.txt and generated operation pages ship from the same source as the SDKs.

04

Honest trade-off: if your team mainly needs collaborative API design governance, SwaggerHub may still be useful upstream. Sourced is the launch and developer-experience layer.