Skip to main content

Apiome user guide

Apiome is where teams design, govern and ship APIs. One path — the spine — runs through the whole product:

import a spec → edit a class and a path → lint → cut a version → publish → browse → export with the CLI → query with MCP

This user guide is for everyone who works in Apiome. It is organised by the job you are doing, in the same order as the product's navigation rail:

SectionWhat it covers
Getting startedSigning in, your first organization and project, versions, publishing and exports — the pages below
BuildProjects, versions, primitives and types, the Studio editor
Bring inThe catalog, the import wizard, repositories and MCP servers
ShipPublishing, the sunset timeline, the export studio, SDKs and mocks
GovernStyle guides, lint posture, the access audit and reviews
Workspace & accountMembers, roles, API keys, tenants, your profile and preferences
GuideFor
Administration guidePeople who run an Apiome installation: the admin console, sign-in providers, the data browser, migrations, operating and hosting
CLIWorking from a terminal or CI with the apiome command: the quick-start and every command
ReferenceThe REST API, the MCP server, the mock runtime and the CI actions
Release notesWhat changed in each release

Each guide has its own entry in the top bar and its own sidebar.

Start here​

Follow these pages in order — from signing in to a published, browsable spec:

  1. Run Apiome locally — only if you are trying Apiome on your own machine
  2. Sign in and create an account
  3. Set up your first organization
  4. The launcher and Home
  5. Import your first project
  6. Version and publish
  7. Browse and export
  8. Connect an MCP host
  9. Keyboard and preferences
Moved from the repository

These pages used to live in the repository's docs/guide/ folder. Its README maps each old file to its page here.