Create a Runta API Key

Use a Runta API key when you want to create runtimes from the runta CLI or from application code.

Create an API Key

1. Open Runta and register or sign in.
2. Open Settings and scroll to Runta API Keys.
3. Select Create API key, enter an alias, and create the key.
4. Copy the key immediately. The full value is only shown after creation.

API keys are bearer credentials. Keep them out of source control and avoid pasting them into shared logs.

Configure Your Shell

Set the token in the shell where you run the CLI or SDK examples:

export RUNTA_TOKEN="rt..."

Verify CLI access:

runta ps -a

Use the Same Token from SDKs

The Python and TypeScript SDKs read the same environment variables:

export RUNTA_TOKEN="rt..."

Python:

With pip:

pip install runta-sdk

Or with uv:

uv pip install runta-sdk

TypeScript:

npm install @runta/runta-sdk

The CLI npm package currently targets Linux x64 and Linux arm64. If npm cannot resolve its native optional dependency, use the CLI artifact from your Runta account or release channel.

Use the source repository’s npm install && npm run build flow only when you are developing the TypeScript SDK itself.

For the full token-to-runtime-to-service flow, see Getting Started.