Skip to main content
Novita.s``ecret.delete() deletes an active Secret by name. A deleted Secret can no longer be referenced by new sandbox create, resume, or clone operations; already-running sandboxes are not rewritten. It returns the name of the deleted Secret.

Prerequisites

CLI

Example

The example creates a Secret, launches a sandbox that references it, uses the placeholder from inside the sandbox, kills the sandbox, and finally deletes the Secret once it is no longer needed.
Deleting a Secret does not rewrite already-running sandboxes; it only prevents new create, resume, and clone operations from referencing it. The underlying retired value is cleaned up asynchronously once no active execution authorization references it. You can reuse the same name to create a new Secret, which gets a new version and placeholder.
Last modified on August 6, 2026