---
title: pulumi env webhook edit | CLI commands
url: /docs/iac/cli/commands/pulumi_env_webhook_edit/
---

Edit an environment webhook.

## Synopsis

[EXPERIMENTAL] Edit an environment webhook

This command updates one or more fields of the named webhook. The CLI fetches the
current webhook, applies the supplied flag values on top of it, and submits the
merged state to the service.

--event replaces the event list. Use --add-event and --remove-event to apply
incremental changes that merge with the existing events; mixing --event with
either of those is not allowed. Event names are validated by the service.

--group, --add-group, and --remove-group behave the same way for event groups.
Valid groups for environment webhooks are: environments, change_requests.

Allowed --format values are: raw, slack, ms_teams, pulumi_deployments. URL
requirements (validated against the format that will be in effect):
  raw, ms_teams:      any http(s) URL
  slack:              must begin with https://hooks.slack.com/
  pulumi_deployments: must be of the form /<stack>

--secret replaces the shared secret. Use --remove-secret to clear an existing
secret; passing --secret "" leaves it unchanged.

```
pulumi env webhook edit [<org-name>/][/]<environment-name> <webhook-name> [flags]
```

## Options

```
      --active                     Whether the webhook is active (default true)
      --add-event stringArray      Subscribe to an additional event (repeatable)
      --add-group stringArray      Subscribe to an additional event group (repeatable)
      --display-name string        The display name
      --event stringArray          Replace the subscribed events (repeatable)
      --format string              The payload format
      --group stringArray          Replace the subscribed event groups (repeatable)
  -h, --help                       help for edit
      --remove-event stringArray   Unsubscribe from an event (repeatable)
      --remove-group stringArray   Unsubscribe from an event group (repeatable)
      --remove-secret              Clear the existing shared secret
      --secret string              Shared secret used to sign deliveries
      --url string                 The payload URL to deliver events to
```

## Options inherited from parent commands

```
      --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
      --env string                   The name of the environment to operate on.
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose
```

## SEE ALSO

* [pulumi env webhook](/docs/iac/cli/commands/pulumi_env_webhook/)	 - Manage environment webhooks