Authentication
API keys and how the SDK reaches the right region.
Isorun authenticates with a single API key. Set it in your environment and the SDK handles everything else, including routing requests to the right region.
import { Isorun } from 'isorun'
// Reads ISORUN_API_KEY from environment
const isorun = new Isorun()
// Or pass it directly
const explicit = new Isorun({ apiKey: 'isorun_live_...' })How regions work
When you sign up you create an organization, and the organization is scoped to a region (US or EU). Every API key belongs to that organization, so the region is baked into the key, and the SDK routes to that region's runner automatically. There's no endpoint to configure and nothing to override.
Environment variable
export ISORUN_API_KEY=isorun_live_...The SDK reads ISORUN_API_KEY automatically. That's the only variable you need.
Treat your key like a password. Keep it in an environment variable or secrets manager, never commit it, and never paste it into a sandbox. If a key leaks, revoke it from the dashboard.
Get a key
Create one in the dashboard. A key is bound to your organization and its region. You can revoke or rotate keys at any time, and an organization can hold as many keys as you need.
Next steps
- Quickstart runs your first sandbox.
- Pricing explains what a sandbox costs.