OpenAPI source and ownership.
Migration planning
Stainless migration checklist.
Before changing generators, inventory the files and repos that control your developer experience: OpenAPI, stainless.yml, SDK repos, docs repo, package names, and release workflows.
Inventory
Inventory
stainless.yml targets, resources, auth, readme examples, and publishing settings.
Production SDK repos and staging repos.
Docs repo dependencies, SDKJSON loading, and custom domain setup.
Launch
Launch checks
Review import paths, constructors, error classes, pagination, examples, and package metadata before publishing.
Review redirects, anchors, canonical URLs, sitemap, llms.txt, and search indexing before launching docs.
Example output
The checklist is based on a real Stainless project.
Sendblue source spec parsed into a replacement plan.
Bloom generated the configured TypeScript SDK method set.
Bloom generated the configured Python SDK method set.
The docs site has Stainless Docs Platform dependencies to replace.
| Example | Why it matters | Current result |
|---|---|---|
| Stainless dashboard inventory | Covers target cards, build history, release setup, diagnostics, billing, settings, and API key surfaces. | Mapped into Bloom dashboard requirements. |
| Sendblue report run | Runs from OpenAPI plus stainless.yml through TypeScript/Python SDK generation and comparison. | SDK generation works; remaining review is focused on final runtime and docs parity. |
| stainless.yml parser | Reads package names, production repos, auth env vars, README example endpoint, and MCP settings. | TypeScript package `sendblue`, Python package `sendblue_api`, MCP package `sendblue-mcp`. |
| Docs dependency scanner | Finds Stainless Docs Platform package version, hosted API dependencies, SDKJSON readiness, and docs migration work. | `@stainless-api/docs` 0.1.0-beta.134, 2 tasks, 2 review items. |
Related pages