api-sandbox 0.1.0

CLI for API sandboxes. Test your APIs in a sandbox env.

sdb

sdb is the CLI for the API sandbox platform from DigitalApi.ai.

It is built for three core jobs:

• import and diff OpenAPI specs
• create sandbox releases and promote aliases
• drive auth, simulation, traces, and generated runtime bundles from one CLI

The public package name is api-sandbox.
The installed binary name is always sdb.

Install

Recommended:

pipx install api-sandbox

Upgrade:

pipx upgrade api-sandbox

If you prefer a virtualenv:

python -m pip install api-sandbox

Quickstart

Local bootstrap:

sdb config bootstrap local
sdb doctor --json

Managed-beta Cloud Run bootstrap:

sdb config bootstrap cloud-run \
  --project api-sandbox-20260416-1715 \
  --base-url https://api.sandbox.digitalapi.ai \
  --profile-name prod \
  --activate

Common flows:

sdb spec import ./openapi.yaml
sdb sandbox create bank-sim --api "Payments API" --mode simulation
sdb sandbox list --name bank-sim
sdb sandbox request bank-sim GET /payments --alias latest
sdb trace tail bank-sim --limit 10

What Works Today

• spec import, validate, diff, list, get
• sandbox create, list, get, clone, archive, reset, export-manifest
• release create, list, get, promote
• auth profiles, apps, client credentials, discovery, scopes, login
• simulation packs, scenarios, snapshots, timers, webhooks, bundles, deploys
• traces: list, get, replay, tail
• runtime requests through sdb sandbox request
• local profiles and private Cloud Run operator profiles
• --dry-run, --yes, --watch, and redacted --trace

Docs

Start here:

• Public CLI install runbook
• CLI contract
• Managed beta production runbook
• Cloud Run operator runbook
• Troubleshooting

Release

Public release path:

• build wheel + sdist
• verify artifacts in CI
• publish to PyPI from a signed GitHub Actions tag workflow

Release checklist:

• docs/RELEASING.md

Repository

This repository also contains the control plane, runtime, runbooks, execution plans, and product contracts that back the CLI.

For repository contributors:

python -m pip install -e ".[dev]"
make check
pytest -q