Python SDK - Secrets#

Encrypted project secrets. Values are masked in lists; reveal returns them one at a time.

Create and list#

secret = db.secrets.set(
    key="API_SECRET",
    value="s3cr3t",
    description="shared with the billing service",  # optional
)

db.secrets.list()

Python

Reveal, update, remove#

revealed = db.secrets.reveal(secret_id)
revealed.data  # {"id": "...", "key": "API_SECRET", "value": "s3cr3t"}

db.secrets.update(secret_id, value="rotated", description="rotated 2026-10")
db.secrets.remove(secret_id)

Python

Next: Webhooks.