Rebuild, cancel, delete

Rebuild

Queue a new build for an existing template, e.g. after a failed build, or to pick up an updated base image.

const build = await template.rebuild()
console.log(`Build queued: ${build.id}`)

build = template.rebuild()
print(f"Build queued: {build.id}")

Rebuild is idempotent: if an in-flight build already exists with the same configuration, you get back the existing build instead of a duplicate. To wait for the new build to finish, poll it by the ID that rebuild() returns. Continuing from the build above:

let current = build
while (!["ready", "failed", "cancelled"].includes(current.status)) {
  await new Promise((resolve) => setTimeout(resolve, 2000))
  current = await template.getBuild(build.id)
}
console.log(current.status, current.errorMessage ?? "")

import time

while build.status.value not in ("ready", "failed", "cancelled"):
    time.sleep(2)
    build = template.get_build(build.id)
print(build.status.value, build.error_message or "")

rebuild() does not update latestBuildId / latest_build_id. On a template returned by Template.create, waitUntilReady() / wait_until_ready() and streamBuildLogs() / stream_build_logs() keep following the first build. A template returned by Template.connect has no latestBuildId, so they follow the most recent build. Polling getBuild() / get_build() with the ID that rebuild() returns works in both cases.

List and inspect builds

const builds = await template.listBuilds({ limit: 10 })
for (const b of builds) {
  console.log(b.id, b.status, b.errorMessage ?? "")
}

const build = await template.getBuild(builds[0].id)

builds = template.list_builds(limit=10)
for b in builds:
    print(b.id, b.status, b.error_message or "")

build = template.get_build(builds[0].id)

Cancel an in-flight build

await template.cancelBuild(build.id)

template.cancel_build(build.id)

cancelBuild is a no-op for builds already in a terminal state.

Delete a template

await template.delete()

// Or by UUID
await Template.deleteById("7a3f2b8c-1234-...")

template.delete()

# Or by UUID
Template.delete_by_id("7a3f2b8c-1234-...")

Both calls are idempotent on 404. If any non-destroyed sandbox still references the template, the call raises ConflictError; destroy those sandboxes first. Once the delete succeeds the template’s name is released for reuse — you can immediately create a new template with the same name.

Get Started

Sandbox

Secrets & env vars

Templates

Commands

Filesystem

Storage

Errors

Rebuild, cancel, delete

Rebuild

List and inspect builds

Cancel an in-flight build

Delete a template

​Rebuild

​List and inspect builds

​Cancel an in-flight build

​Delete a template

​Related

Rebuild

List and inspect builds

Cancel an in-flight build

Delete a template

Related