Skip to content
All comparisons

APIGit vs Stoplight

Stoplight is a visual API designer that works on top of a Git repository you host on GitHub, GitLab, Bitbucket or Azure DevOps, or keeps a project in its own storage. APIGit is the Git host: the repository, the pull requests, the published docs and the mock servers are in one place.

Stoplight is an API design and documentation platform by SmartBear. Facts checked against its public documentation on 19 November 2026.

APIGit

Your editor, the browser or a coding agent
git push, git pull
A Git repository on APIGit
from a commit
Docs, mock servers and rule checks

Stoplight

Stoplight Studio
save
A Stoplight project
Git projects: push and pull
Your repository on GitHub, GitLab, Bitbucket or Azure DevOps
A Stoplight Git project works on a repository you host elsewhere; other projects keep their data in Stoplight.

The short version

The repository is in APIGit

A Stoplight Git project reads and writes a repository on another Git host; a Stoplight project without Git keeps its data in Stoplight. An APIGit project is a Git repository with its own HTTPS and SSH address.

Review without leaving

Stoplight offers discussions and a graphical diff; pull requests happen on your Git provider. In APIGit the pull request, the reviewers and the merge are next to the editor.

Stoplight's open-source roots

Spectral, the linter APIGit's governance runs on, and Prism, a widely used mock server, both come from Stoplight.

Git, side by side

An APIGit project is a Git repository from its first commit. This is what that means next to Stoplight, topic by topic.

TopicAPIGitStoplight
Where your API files liveYes:In a Git repository that APIGit hosts: specs, Markdown and mock scripts as filesPartly:Git projects keep files in a repository on your Git provider; Stoplight projects keep them in Stoplight
Clone and push with any Git clientYes:HTTPS with a token, or SSH at git.apigit.comNo:Stoplight is not a Git host: you clone from your own Git provider
Branches and tagsYes:Git branches and tags, created in the browser or pushed from your machineYes:Git branches in Git projects; multi-branch support starts on the Startup plan
Pull requests and reviewYes:Built in: reviewers, approvals, and merge, rebase or squashPartly:Discussions and a graphical diff; pull requests happen on your Git provider
Commit history and diffYes:Every commit of every branch, with a unified or split diffPartly:A comparison of changes in Studio; history is on your Git provider
Working with GitHub, GitLab and othersYes:Optional: two-way sync with a remote repository, or push mirrors (Enterprise)Yes:Push and pull with GitHub, GitLab, Bitbucket and Azure DevOps; self-hosted Git on Pro Team
  • Yes:Has it
  • Partly:Has part of it; the cell says which
  • No:Does not have it

Feature by feature

Design, documentation, mock servers, governance, testing, agents and plans. Where Stoplight has something APIGit lacks, the table says so.

TopicAPIGitStoplight
API design
OpenAPI versionsYes:OpenAPI 3.0 and 3.1, Swagger 2.0Yes:OpenAPI 2.0, 3.0 and 3.1
Visual editor for OpenAPIYes:A form view beside the code view, with a diff before you commitYes:A visual form editor and a code editor, with JSON Schema models
AsyncAPI and GraphQLYes:Both: edit as code, preview and publish, in the same repositoryPartly:JSON Schema models; AsyncAPI only as Spectral lint rules
Documentation
Hosted documentationYes:One site for OpenAPI, AsyncAPI, GraphQL and Markdown, published from a commitYes:Hosted docs with a try-it console and Markdown pages
Custom domainYes:On Team and EnterpriseYes:From the Startup plan
Try it consoleYes:Try It Out for OpenAPI, on every planYes:Try it in the hosted docs
Private documentationYes:Members only, named external viewers, or a password-protected linkYes:Private or public docs; SAML single sign-on from Pro Team
Mock servers
Hosted mock server from a specYes:From OpenAPI documents or a GraphQL schema, with request validationYes:Hosted Prism mocks: static from examples or dynamic generated data, with request validation
Mocks with your own code and stateYes:Express.js scripts from the repository (Team and Enterprise)No:No custom scripts are documented
Mock on your machineYes:apigit mock serve, from the working copyYes:Prism is open source and runs locally
Governance
Style rules for API descriptionsYes:Spectral: two built-in rule sets, your own on EnterpriseYes:Spectral style guides in the editor; shared style guides on higher plans
Breaking-change checkYes:apigit breaking, between two Git refs, in a terminal or in CINo:Not documented
API client and testing
API client for sending requestsPartly:Try It Out in the reference; no standalone client or saved collectionsPartly:Try it in the docs
Test scenarios, runners and monitorsNo:Not providedNo:No test runner or monitors are documented
CLI and AI agents
Command lineYes:apigit: lint, score, diff, breaking, preview, mock and publish; the checks run offline with no accountPartly:@stoplight/cli publishes a directory to a project; Spectral and Prism have their own CLIs
MCP serverYes:One for each published document, and one for your accountNot covered in this check
Plans
Free planYes:1 user, 1 published document, 1 mock serverYes:1 user, 1 project
First paid planYes:Team: $24 a month, 3 seats included; $8 per further seatYes:Basic: $44 a month billed yearly, 3 users included; $11 per further user

Checked on 19 November 2026 against each vendor's public documentation and pricing pages. APIGit's column follows our documentation and pricing. Products change: if a cell is out of date, tell us and we will correct it. Product names are trademarks of their owners.

Sources

Where Stoplight is the better choice

A comparison that only lists our strengths is an advertisement. These are the things it does that we do not, or does better.

A visual designer for everyone

Stoplight's form editor, with JSON Schema models and shared component libraries, was built so that people who do not write YAML can design an API.

Spectral and Prism

Both are open source and widely adopted. Prism's dynamic mode generates data from the schema, and it runs anywhere. APIGit's governance uses Spectral.

It works on the repository you have

If your specs must stay on GitHub, GitLab, Bitbucket or Azure DevOps, Stoplight edits them there on every plan. In APIGit, sync with an external repository needs the Enterprise plan.

Choose Stoplight when

  • Your specs must stay on the Git host you already use
  • You rely on Prism's generated mock data
  • You design JSON Schema models shared between many APIs

Choose APIGit when

  • You want the repository, review, docs and mocks in one product, with no second Git host
  • Pull requests should show governance findings beside the diff
  • Mock servers need your own code and state
  • You document AsyncAPI and GraphQL beside OpenAPI, and want an MCP server for agents

Moving an API from Stoplight

  1. Start from the repository

    A Stoplight Git project is already a repository of OpenAPI and Markdown files on your Git provider. Export a Stoplight project that is not on Git as files first.

  2. Migrate it into APIGit

    Use the migration when you create the repository to copy it in, or commit the exported files to a new repository.

  3. Reuse your Spectral rules

    Your Spectral style guide becomes a custom rule profile on the Enterprise plan, and apigit lint uses a .spectral.yaml in the working directory on any plan.

An exported OpenAPI file into a new repository, commands only
$ git clone git@git.apigit.com:acme/orders-api.git$ cd orders-api$ cp ~/Downloads/openapi.yaml .$ apigit lint openapi.yaml$ git add openapi.yaml$ git commit -m "Import the orders API"$ git push

Questions about APIGit and Stoplight

What is the main difference between APIGit and Stoplight?
Stoplight is a design and documentation layer on top of a Git repository hosted somewhere else, or on its own storage for projects without Git. APIGit hosts the Git repository itself, so cloning, branches, pull requests, published documentation and mock servers are all in one product.
Is Stoplight Git-native?
Stoplight's Git projects work directly on a repository at GitHub, GitLab, Bitbucket or Azure DevOps, with Git branches and push and pull. Stoplight is not a Git host, so pull requests, history and access to the repository are managed on that provider.
Is Stoplight being discontinued?
On the day of this check Stoplight's site and pricing page were live and sign-up was open. SmartBear, which owns Stoplight, also publishes a guide for migrating data from Stoplight into its Swagger products. We found no official end date.
Can I keep my Spectral style guide in APIGit?
Yes. APIGit's governance runs on Spectral. The two built-in rule sets are on every plan, and custom rule profiles, where your own Spectral rules go, are on the Enterprise plan. The apigit CLI uses a .spectral.yaml in the working directory when it lints.
How do the mock servers compare?
Stoplight hosts Prism, which answers from examples or generates data from the schema and validates requests. APIGit's spec-based mocks answer from OpenAPI documents and GraphQL schemas with validation, and its code-based mocks run Express.js scripts with state.

Other comparisons

Try it yourself

Worked examples from the learn hub, each with the output of the tools.

Put one API in a repository and see

Create a free workspace, commit the OpenAPI file you already have, and open a pull request against it. It is Git from the first commit.

Free for individuals. No credit card.

$ npm install -g @apigit/cli$ apigit auth login$ apigit doc publish