Skip to content
Runta Runta

Apply for a Runta Token

Use an API token when you want to create runtimes from the runta CLI or from application code.

Apply for a token

Section titled “Apply for a token”
  1. Open Runta and register or sign in.
  2. Open account or workspace settings.
  3. Apply for an API token for CLI and SDK access.
  4. Copy the token once it is issued.

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

Configure your shell

Section titled “Configure your shell”

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

Terminal window
export RUNTA_TOKEN=<tenant_token>

Verify CLI access:

Terminal window
runta ps -a

Use the same token from SDKs

Section titled “Use the same token from SDKs”

The Python and TypeScript SDKs read the same environment variables:

Terminal window
export RUNTA_TOKEN=<tenant_token>

Python:

With pip:

Terminal window
pip install runta-sdk

Or with uv:

Terminal window
uv pip install runta-sdk

TypeScript:

Terminal window
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.