Isorun Docs
Getting Started

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.

TypeScript
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

Terminal
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

On this page