Migration guide

Migrate from Stainless to Octri

Upload stainless.yml with the OpenAPI file beside it. Your targets, package name, production repository and method names come across, and your users keep installing the packages they already have.

Written by Octri · Checked 25 October 2026

What to have to hand

Octri reads Stainless’s own files. A .zip of your repository or a single config file, up to 15 MB.

  • stainless.yml
  • openapi.yml

What comes across

Each row is a field the Stainless importer reads, and where it lands. Rows marked “By hand” are what is left for you.

WhatIn OctriFrom Stainless
SDK languagesOne SDK per targettargets
Package nameSDK package namepackage_name of the first target
RepositoryThe SDK repositoryproduction_repo
Project nameProject nameorganization.name
Method groupingMethods grouped by tagresources
Method namesPer-endpoint namesx-stainless-method-name in your spec
Names inside resourcesSet in SDK StudioBy hand

Step by step

  1. Bring it in

    Sign up, choose Switch to Octri when onboarding asks for your spec, and drop in stainless.yml with your OpenAPI file, or a .zip of the repository that holds both.

  2. Check the preview

    Before anything is created, Octri shows what it found: the spec, each target as an SDK language, the package name, the repository, and which methods carry a name from your spec. Anything it could not carry is named in a note under the preview, so you know what is left to do by hand.

  3. Check the surface

    Method names set under resources are not read, so set those in SDK Studio, where the preview shows each call as your users will write it. Compare it with the package you ship today before the first release.

  4. Release one language first

    Release one language under its existing package name as a new major version, then add the rest one at a time. Each regeneration after that opens a pull request in that language’s repository.

  5. Go live

    Publish, then point your custom domain at Octri last, so readers keep the old site until the new one is ready. From then on every merged spec change rebuilds the draft of your docs, SDKs and MCP tools, ready for you to publish.

Questions

The importer skips them and names each one in the preview. Octri generates SDKs in TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift and Dart.

Still deciding?

The comparison sets Octri against Stainless row by row, from each product’s own pages, with Octri’s prices beside them.

Try it on your own spec

Bring what you have from Stainless on the Free plan and see your reference written and your first SDK built.