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 APIMatic to Octri

The move starts from two things an APIMatic project already has: the API definition its SDKs are built from, and its portal’s guides as Markdown.

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.json
Portal guides as Markdown

What comes across

APIMatic 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 APIMatic
API reference	A page for every endpoint, written for you	Your OpenAPI file
Guides	Page drafts, by Pull from GitHub	Your portal’s Markdown guides
Redirects	octri.json	Your portal redirects, by hand
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
Sign up and upload your OpenAPI file, or connect the repository it lives in. A RAML or WSDL definition goes through APIMatic’s Transformer to OpenAPI first.
Pull your guides from GitHub
Connect the repository that holds your portal’s Markdown guides, 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.
Set up your SDKs
Pick your languages in SDK Studio. Every language is in the plan, so there is no per-language bill to plan around. 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. 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.