feat(templates): template list pagination via GET /v2/templates by huv1k · Pull Request #1479 · e2b-dev/E2B

huv1k · 2026-06-24T13:07:54Z

Summary

Adds support for listing templates with pagination via the new GET /v2/templates endpoint (added to spec/openapi.yml, clients regenerated). The JS and Python SDKs gain a Template.list() paginator (TemplatePaginator / AsyncTemplatePaginator, yielding TemplateInfo) mirroring Sandbox.list(), and e2b template list now pages through results behind a new -l, --limit option (default 1000, 0 for no limit) with a "Showing first N…" hint. Pagination uses the limit/nextToken query params and the X-Next-Token response header, consistent with sandbox list. Covered by new unit tests (msw-based SDK test + mocked CLI test); minor version bump for all three packages via changeset.

Usage

CLI:

e2b template list                 # all templates (paginated under the hood)
e2b template list --limit 20      # cap at 20, prints a "Showing first 20…" hint
e2b template list --limit 0 -f json

JS SDK:

import { Template } from 'e2b'

const paginator = Template.list({ limit: 100 })
while (paginator.hasNext) {
  const templates = await paginator.nextItems()
  console.log(templates)
}

Python SDK:

from e2b import Template  # or AsyncTemplate

paginator = Template.list(limit=100)
while paginator.has_next:
    for t in paginator.next_items():
        print(t.template_id)

Add a paginated `GET /v2/templates` endpoint to the spec and expose it across all packages: - JS SDK: `Template.list()` -> `TemplatePaginator` returning `TemplateInfo`, matching `Sandbox.list()`. - Python SDK: `Template.list()` / `AsyncTemplate.list()` -> `TemplatePaginator` / `AsyncTemplatePaginator` (sync + async). - CLI: `e2b template list` pages through templates via the SDK paginator and adds a `-l, --limit` option (default 1000, 0 for no limit). Pagination uses `limit`/`nextToken` query params and the `X-Next-Token` response header, consistent with `sandbox list`.

linear-code · 2026-06-24T13:07:58Z

EN-603

changeset-bot · 2026-06-24T13:08:10Z

🦋 Changeset detected

Latest commit: df8f73c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@e2b/python-sdk	Minor
e2b	Minor
@e2b/cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-06-24T13:08:56Z

Package Artifacts

Built from b2369d3. Download artifacts from this workflow run.

JS SDK (e2b@2.30.6-templates-list-pagination-for-cli-en-603.0):

npm install ./e2b-2.30.6-templates-list-pagination-for-cli-en-603.0.tgz

CLI (@e2b/cli@2.12.3-templates-list-pagination-for-cli-en-603.0):

npm install ./e2b-cli-2.12.3-templates-list-pagination-for-cli-en-603.0.tgz

Python SDK (e2b==2.29.5+templates-list-pagination-for-cli-en-603):

pip install ./e2b-2.29.5+templates.list.pagination.for.cli.en.603-py3-none-any.whl

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 760d988327

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Template.list builds its own ConnectionConfig, so passing only teamId/limit left config-file logins (e2b auth login) unauthenticated. Resolve the API key via ensureAPIKey() and pass it to the paginator, mirroring sandbox list. This also fixes the delete/publish --select flows.

mishushakov

move template method to template and shared classes to utils

mishushakov · 2026-06-24T14:13:30Z

+  /**
+   * Identifier of the team whose templates should be listed. Defaults to the
+   * team the API key belongs to.
+   */
+  teamId?: string


that makes no sense, API key is scoped per team, I cannot check templates for a different team with same API key

mishushakov · 2026-06-24T14:14:25Z

@@ -0,0 +1,185 @@
+import { ApiClient, components, handleApiError } from '../api'
+import { ConnectionConfig } from '../connectionConfig'
+import { BasePaginator, SandboxApiOpts } from '../sandbox/sandboxApi'


importing anything from Sandbox here is no-bueno, if it's shared it should go to shared utils.ts

mishushakov · 2026-06-24T14:15:28Z

+ * }
+ * ```
+ */
+export class TemplatePaginator extends BasePaginator<TemplateInfo> {


BasePaginator might not be re-usable here - its constructor opts are SandboxApiOpts
maybe you can make BasePaginator constructor more generic?

mishushakov · 2026-06-24T14:16:56Z

+    if (!this.hasNext) {
+      throw new Error('No more items to fetch')
+    }


please check in other places in SDK - but not having next items should not raise any error - instead remove empty []

if that's the case elsewhere - add some comment that we'll be changing this

mishushakov · 2026-06-24T14:18:01Z

+    return (res.data ?? []).map(
+      (template: components['schemas']['Template']) => ({
+        templateId: template.templateID,
+        buildId: template.buildID,
+        cpuCount: template.cpuCount,
+        memoryMB: template.memoryMB,
+        diskSizeMB: template.diskSizeMB,
+        public: template.public,
+        aliases: template.aliases ?? [],
+        names: template.names ?? [],
+        createdAt: new Date(template.createdAt),
+        updatedAt: new Date(template.updatedAt),
+        lastSpawnedAt: template.lastSpawnedAt
+          ? new Date(template.lastSpawnedAt)
+          : null,
+        spawnCount: template.spawnCount,
+        buildCount: template.buildCount,
+        envdVersion: template.envdVersion,
+        createdBy: template.createdBy ?? null,
+        buildStatus: template.buildStatus,
+      })


I think you can just spread most of these

mishushakov · 2026-06-24T14:20:54Z

+        if not self.has_next:
+            raise Exception("No more items to fetch")


same as in JS

mishushakov · 2026-06-24T14:22:09Z

everything I said above applies here

mishushakov · 2026-06-24T14:22:28Z

 from e2b.template.main import TemplateBase, TemplateClass
 from e2b.template.types import BuildInfo, InstructionType, TemplateTag, TemplateTagInfo
 from e2b.template.utils import normalize_build_arguments, read_dockerignore
+from e2b.sandbox_async.paginator import AsyncTemplatePaginator


importing from sandbox here is no-bueno

mishushakov · 2026-06-24T14:23:01Z

+from .sandbox_async.paginator import (
+    AsyncSandboxPaginator,
+    AsyncSnapshotPaginator,
+    AsyncTemplatePaginator,


mishushakov · 2026-06-24T14:26:24Z

+      throw err
+    }
+
+    this.updatePagination(res.response)


is there a particular reason we have this method in the JS SDK but not in Python?

mishushakov · 2026-06-24T14:40:51Z

also, no tests for the Python SDKs?

mishushakov

more CLI feedback

mishushakov · 2026-06-24T14:30:50Z

 export const listCommand = new commander.Command('list')
  .description('list sandbox templates')
  .alias('ls')
  .addOption(teamOption)


this option should be prob deprecated

mishushakov · 2026-06-24T14:42:11Z

please make it integration test instead, not mock

mishushakov · 2026-06-24T14:42:49Z

same here - no mock pls

mishushakov · 2026-06-24T14:50:39Z

+          console.log(
+            `Showing first ${limit} templates. Use --limit to change.`
+          )


no need for this, our users can count

mishushakov · 2026-06-24T14:52:32Z

+// Adapt the SDK's TemplateInfo back to the raw API schema shape the rest of the
+// CLI (table rendering, selection prompts, `--format json`) is built around.
+function toTemplateSchema(


is it actually an issue?

mishushakov · 2026-06-24T14:58:04Z

 import { teamOption } from '../../options'
-import { handleE2BRequestError } from '../../utils/errors'
+
+const DEFAULT_LIMIT = 1000


I think it's fine for now to just return the whole list, auto-paginate should be cheap op.
the reason is that ppl pipe the CLI output into other tools and we don't have a good way to paginate in the CLI - perhaps next task to figure out?

cla-bot Bot added the cla-signed label Jun 24, 2026

Merge branch 'main' into templates-list-pagination-for-cli-en-603

760d988

huv1k marked this pull request as ready for review June 24, 2026 13:45

huv1k requested review from ValentaTomas, jakubno and mishushakov as code owners June 24, 2026 13:45

chatgpt-codex-connector Bot reviewed Jun 24, 2026

View reviewed changes

Comment thread packages/cli/src/commands/template/list.ts Outdated

claude Bot reviewed Jun 24, 2026

View reviewed changes

Comment thread packages/cli/src/commands/template/list.ts

mishushakov requested changes Jun 24, 2026

View reviewed changes

mishushakov reviewed Jun 24, 2026

View reviewed changes

		if not self.has_next:
		raise Exception("No more items to fetch")

Conversation

huv1k commented Jun 24, 2026

Summary

Usage

Uh oh!

linear-code Bot commented Jun 24, 2026

Uh oh!

changeset-bot Bot commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions Bot commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Package Artifacts

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

mishushakov left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mishushakov commented Jun 24, 2026

Uh oh!

mishushakov left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot Bot commented Jun 24, 2026 •

edited

Loading

github-actions Bot commented Jun 24, 2026 •

edited

Loading