List templates
Template.list returns a paginator over your project’s templates, newest first. Pass limit to set the page size (1 to 100, defaults to 100) and nextToken to resume from a previous page.
AsyncTemplate.list() and await paginator.next_items().
Each template includes templateId, names, buildId, buildStatus, cpuCount, memoryMB, diskSizeMB, envdVersion, public, createdAt, updatedAt, lastSpawnedAt, spawnCount, and buildCount (snake_case in Python, e.g. template_id, memory_mb).
Get a template and its default build
GET /v2/templates/{templateID} returns one template by its ID, name, or team/name. Encode the slash in team/name as %2F, for example /v2/templates/my-team%2Fmy-template. The response includes defaultBuild, the build a sandbox starts from when you don’t pass a tag. This is the latest ready build tagged default.
cURL
defaultBuildis absent until a build taggeddefaultis ready.buildStatusreports the latest build taggeddefaultin any state. During a rebuild it readsbuilding, whiledefaultBuildstill shows the ready build that sandboxes start from.- The response doesn’t include the deprecated
aliasesfield. Usenamesinstead.
List a template’s builds
GET /templates/{templateID}/builds lists a template’s builds, newest first. Each build includes buildID, status, cpuCount, maxCpuCount, memoryMB, and the tags that point at it.
cURL
A template named
aliases can’t be given by its bare name here. Use its ID or its namespaced name, such as my-team%2Faliases.
A tag points at the latest ready build it was assigned to, which is the build a sandbox started with that tag runs. A pending or failed rebuild carries no tag.
Both endpoints return 400 when the template reference includes a tag, such as my-template:v2. They return 404 when the template is missing, deleted, or belongs to another team.
Delete a template
Template.delete() deletes a template or snapshot by ID or name. It returns true if the template was deleted and false if it wasn’t found.