webhook

Manage webhooks for an organization. Webhooks deliver HTTP POST requests to a target URL when events occur (e.g. secrets are pushed or deleted). Requires admin or owner role.

Service tokens cannot manage webhooks. All webhook commands require a user token.

webhook list

envshed webhook list [options]

Lists all webhooks for the organization.

Options

Option	Description
-o, --org <slug>	Organization slug
--output json	Print JSON output

webhook create

envshed webhook create [options]

Creates a new webhook. A CSPRNG-generated signing secret is displayed once at creation time — save it immediately.

Options

Option	Description
--name <name>	Webhook name (required)
--url <url>	Target URL — must be HTTPS (required)
--events <events>	Comma-separated event types, e.g. push,delete (required)
--type <type>	Webhook type (default: http)
-o, --org <slug>	Organization slug
--output json	Print JSON output

webhook update

envshed webhook update <id> [options]

Updates an existing webhook. At least one option must be provided.

Options

Option	Description
--name <name>	New webhook name
--url <url>	New target URL
--events <events>	New comma-separated event types
--active / --no-active	Enable or disable the webhook
-o, --org <slug>	Organization slug
--output json	Print JSON output

webhook delete

envshed webhook delete <id> [options]

Deletes a webhook. Prompts for confirmation unless --yes is passed.

Options

Option	Description
-o, --org <slug>	Organization slug
-y, --yes	Skip confirmation prompt
--output json	Print JSON output

webhook test

envshed webhook test <id> [options]

Sends a test webhook.test event to the webhook URL and shows the HTTP response status and latency. The response body is never shown.

Options

Option	Description
-o, --org <slug>	Organization slug
--output json	Print { "status": N, "latency_ms": N }