Skip to main content
Novita.secret``.list() returns the metadata of all active Secrets for the current authenticated team. It does not return real values, retired versions, or unfinished pending versions. Use it to discover which Secrets are available before referencing one from a sandbox.

Prerequisites

CLI

Example

The example ensures a Secret exists, lists the team’s active Secrets with novita.secret.list(), launches a sandbox that references one of them, uses the placeholder from inside the sandbox, and kills the sandbox when done.
novita.secret.list() takes no business parameters and returns a list of SecretBinding metadata. An empty list means the current team has no active Secrets. Real values, retired versions, and pending versions are never returned.
Last modified on August 6, 2026