Will someone help with the move?

Yes. Book a call and a founder will go through your project with you and help the first release over by hand. Questions also reach us at founders@octri.dev.

Migration guide

Migrate from Redocly to Octri

The move starts from three things a Redocly project already has: the OpenAPI file its reference is built from, its Markdown in Git, and the redirects in redocly.yaml.

Start on the Free plan Book a call

Written by Octri · Checked 25 October 2026

What to have to hand

Your OpenAPI file, and your Markdown in a GitHub repository. Everything else is set in API Studio and SDK Studio.

openapi.yaml
redocly.yaml
docs/*.md

What comes across

Redocly has no config for Octri to read, so the move runs on files you already have. Rows marked “By hand” are what is left for you.

What	In Octri	From Redocly
API reference	A page for every endpoint, written for you	Your OpenAPI file
Guides	Page drafts, by Pull from GitHub	Your Markdown in Git
Redirects	octri.json	redocly.yaml
Logo, colours and fonts	Set in API Studio	By hand
SDKs	Generated in the languages you pick	Nothing to bring

Step by step

Bring the spec
If your spec spans several files, bundle it with redocly bundle, then sign up and upload the result, or connect the repository it lives in.
Pull your guides from GitHub
Connect the repository that holds your Redocly Markdown, then choose Pull from GitHub in the API Studio Files panel. Pick up to 50 Markdown or MDX files at a time and each lands as a page draft, with its title, description, icon and badge taken from the frontmatter. Switch on sync on push and later edits in Git keep landing on the same pages.
Swap Markdoc tags
Markdoc tags such as {% admonition %} and {% tabs %} become <Callout> and <Tabs>. The page preview shows each one as you change it.
Set up your SDKs
Pick your languages in SDK Studio, and the call through each SDK appears on every endpoint page. Give each language the package name your users already install, and publish the first Octri release as a new major version, since method names and types can change. Every later spec change arrives in the SDK repository as a pull request.
Keep your old links working
Open octri.json in the Files panel and add a redirect for each old path, starting with the ones in redocly.yaml. A rule that ends in /* covers a whole section, and a project keeps up to 500 of them.
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

No. The importer only reads the files you upload, and Pull from GitHub only reads your repository. Nothing is written back to either, so your current site keeps running until you move the domain.