Files

T

Mish Ushakov 31ad497635 feat(cli): accept E2B_API_KEY in template list & create (#1361 )

## Summary

`E2B_ACCESS_TOKEN` is deprecated, so CLI commands whose endpoints accept
either credential now authenticate with `E2B_API_KEY` instead of
requiring an access token.

- `e2b template list` now uses `ensureAPIKey()`. The underlying `GET
/templates` endpoint accepts both `ApiKeyAuth` and `AccessTokenAuth`,
and since the access token is deprecated we standardize on the API key.
- `e2b template create` no longer calls `ensureAccessToken()`. Its only
API calls — `POST /v3/templates` and `POST
/v2/templates/{id}/builds/{bid}` (via the SDK's `Template.build`) —
accept only `ApiKeyAuth`, so requiring an access token locked out
API-key-only environments for no reason.
- `e2b template build` is intentionally left as-is: its v1 endpoints and
docker-registry login are access-token-only at the API level.
- Removed the now-unused `ensureAccessTokenOrAPIKey()` helper and the
`'BOTH'` variant of the auth-error box that an earlier iteration of this
PR introduced.
- Adds a real backend-integration test in
`tests/commands/template/create.test.ts` that mirrors the existing
`backend_integration.test.ts` pattern: use the real `E2B_DOMAIN` and
assert end-to-end that `template create` succeeds with only
`E2B_API_KEY` set (no `E2B_ACCESS_TOKEN`). Uses a unique template name
per run and cleans up the created template in `afterAll`.

## Test plan

- [x] `pnpm --filter @e2b/cli run typecheck`
- [x] `pnpm --filter @e2b/cli run lint`
- [x] `pnpm --filter @e2b/cli run format`
- [x] `pnpm --filter @e2b/cli run test` (local, with real `E2B_API_KEY`
— new test passes; create succeeds without `E2B_ACCESS_TOKEN`)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

2026-06-16 11:25:41 +02:00

src

feat(cli): accept E2B_API_KEY in template list & create (#1361 )

2026-06-16 11:25:41 +02:00

testground/demo-basic

New infra (#212 )

2023-11-06 15:07:09 +01:00

tests

feat(cli): accept E2B_API_KEY in template list & create (#1361 )

2026-06-16 11:25:41 +02:00

.envrc

Ensure that httpx transport is reused across calls by default (#997 )

2025-11-14 16:48:29 -08:00

.eslintrc.cjs

Migrate CLI to Beta SDK

2024-09-13 09:59:45 +02:00

.gitignore

feat: add template migration to CLI (#880 )

2025-09-19 17:41:28 +02:00

.prettierignore

feat: add template init for new template SDK (#881 )

2025-09-26 06:40:58 -07:00

LICENSE

Added license sources to SDKs (#761 )

2025-06-05 07:10:07 -07:00

package.json

[skip ci] Release new versions

2026-06-10 17:33:36 +00:00

README.md

feat(cli): fully deprecate template build command (v1) (#1390 )

2026-06-08 10:50:40 +02:00

tsconfig.json

Migrate CLI to Beta SDK

2024-09-13 09:59:45 +02:00

tsup.config.js

feat: add template migration to CLI (#880 )

2025-09-19 17:41:28 +02:00

vitest.config.ts

fix: CLI tests setup (#969 )

2025-10-17 05:03:18 -07:00

README.md

E2B CLI

This CLI tool allows you to build manager your running E2B sandbox and sandbox templates. Learn more in our documentation.

1. Install the CLI

Using Homebrew (on macOS)

brew install e2b

Using NPM

npm install -g @e2b/cli

2. Authenticate

e2b auth login

Note

To authenticate without the ability to open the browser, provide E2B_ACCESS_TOKEN as an environment variable. You can find your token in Account Settings under the Team selector at e2b.dev/dashboard. Then use the CLI like this: E2B_ACCESS_TOKEN=sk_e2b_... e2b template create.

Important

Note the distinction between E2B_ACCESS_TOKEN and E2B_API_KEY.

3. Check out docs

Visit our CLI documentation to learn more.