Rebuild, cancel, delete - Superserve

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.

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.