Advanced CLI
Webhooks
Section titled “Webhooks”Webhooks send HTTP notifications when secrets change.
List Webhooks
Section titled “List Webhooks”passbox webhook list [options]| Option | Description |
|---|---|
--vault <name> | Vault name or ID |
Create a Webhook
Section titled “Create a Webhook”passbox webhook create [options]| Option | Description |
|---|---|
--vault <name> | Vault name or ID |
--name <name> | Webhook name |
--url <url> | HTTPS endpoint URL |
--events <events> | Comma-separated: secret.created, secret.updated, secret.deleted, secret.rotated |
passbox webhook create \ --vault my-app \ --name "slack-notify" \ --url "https://hooks.slack.com/..." \ --events "secret.created,secret.updated"Update a Webhook
Section titled “Update a Webhook”passbox webhook update <id> [options]| Option | Description |
|---|---|
--url <url> | New URL |
--events <events> | New events |
--active <bool> | Enable/disable |
Delete a Webhook
Section titled “Delete a Webhook”passbox webhook delete <id> [options]Test a Webhook
Section titled “Test a Webhook”passbox webhook test <id> [options]Sends a test event to the webhook URL.
Secret Rotation
Section titled “Secret Rotation”Configure automatic rotation tracking for secrets.
Get Rotation Config
Section titled “Get Rotation Config”passbox rotation get <secret-name> [options]| Option | Description |
|---|---|
--vault <name> | Vault name or ID |
Set Rotation Config
Section titled “Set Rotation Config”passbox rotation set <secret-name> [options]| Option | Description |
|---|---|
--vault <name> | Vault name or ID |
--interval <hours> | Rotation interval in hours (default: 720 = 30 days) |
--webhook <id> | Webhook to notify on rotation |
passbox rotation set API_KEY --vault my-app --interval 168 # weeklyRemove Rotation
Section titled “Remove Rotation”passbox rotation remove <secret-name> [options]Trigger Manual Rotation
Section titled “Trigger Manual Rotation”passbox rotation trigger <secret-name> [options]Fires the secret.rotated webhook event immediately.
Account Management
Section titled “Account Management”Delete Account
Section titled “Delete Account”passbox account deletePermanently deletes your account and all associated data. Requires confirmation.
Configuration
Section titled “Configuration”Get Config Value
Section titled “Get Config Value”passbox config get <key>Available keys: server, defaultVault, defaultEnvironment
Set Config Value
Section titled “Set Config Value”passbox config set <key> <value>passbox config set server https://api.passbox.devpassbox config set defaultVault my-apppassbox config set defaultEnvironment productionMCP Server
Section titled “MCP Server”Start MCP Server
Section titled “Start MCP Server”passbox serveStarts the PassBox MCP server in stdio mode for use with AI tools like Claude Desktop, Cursor, or Windsurf. See MCP Setup for configuration details.
Who Am I
Section titled “Who Am I”passbox whoamiDisplays the email of the currently authenticated user.