Get an API key

Every SDK call is authenticated with an API key. Keys are prefixed with ss_live_ and scoped to a single team.

1. Create a key in the console

Go to console.superserve.ai, open Settings → API keys, and click Create key. Copy the value - it’s only shown once.

Treat API keys like passwords. Never commit them to source control or paste them into client-side code.

By default, the SDK reads SUPERSERVE_API_KEY from the environment.

export SUPERSERVE_API_KEY=ss_live_...

You can also pass the key explicitly - useful in serverless environments where env vars are awkward.

import { Sandbox } from "@superserve/sdk"

const sandbox = await Sandbox.create({
  name: "explicit-key",
  apiKey: process.env.MY_KEY,
})

import os
from superserve import Sandbox

sandbox = Sandbox.create(
    name="explicit-key",
    api_key=os.environ["MY_KEY"],
)