Hosted API simulations from your OpenAPI specs.
Push to GitHub, get a dedicated simulation URL in seconds.
No config, no servers, no accounts to create.
You push code
-> GitHub Action packages your OpenAPI specs
-> Mockzilla provisions a dedicated simulation in your nearest AWS region
-> Live at api.mockzilla.org/gh/{org}/{repo}/{ref}/
Every branch gets its own URL. Every push updates it. When the PR closes, the simulation is torn down automatically.
Add this to .github/workflows/mockzilla.yml:
name: Mockzilla
on: [push, pull_request]
jobs:
simulate:
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: write
steps:
- uses: actions/checkout@v4
- uses: mockzilla/actions/portable@main
with:
token: ${{ secrets.GITHUB_TOKEN }}
spec-dir: openapi # path to your OpenAPI specsPush. That's it. No API keys, no secrets, no signup.
Or start from a template: mockzilla-portable-template / mockzilla-codegen-template
brew tap mockzilla/tap
brew install mockzilla
mockzilla https://petstore3.swagger.io/api/v3/openapi.json- Spec-driven simulation that matches your API contract exactly, with realistic response generation
- PR environments where every pull request gets its own URL
- 24 AWS regions with latency-based routing
- Two modes: portable (just specs) or codegen (typed Go handlers with custom logic)
- Rate limit headers on every response for integration testing
- API key auth to protect simulations when needed
| Repo | What it does |
|---|---|
| actions | GitHub Action for portable and codegen modes |
| Mockzilla | OpenAPI mock engine powering all simulations |
| mockzilla-portable-template | Starter template for portable mode |
| mockzilla-codegen-template | Starter template for codegen mode |
| homebrew-tap | brew install mockzilla/tap/mockzilla |
