---
title: "Update Notification Webhook"
method: PUT
path: "/api/notification_webhooks/deployments/{deploymentId}/webhooks/{webhookId}"
tags: ["NotificationWebhooksService"]
---

# Update Notification Webhook

`PUT /api/notification_webhooks/deployments/{deploymentId}/webhooks/{webhookId}`

Update a notification webhook by replacement.

## Path parameters

- `deploymentId` string, required
- `webhookId` string, required

## Request body

- ProtosNotificationWebhooksV1UpdateNotificationWebhookRequest
  - `deploymentId` string
  - `webhookId` string
  - `name` string — The user-specified name for the webhook
  - `url` string — The URL endpoint where webhook payloads will be sent
  - `useNetworkBroker` boolean — Whether to use the network broker for webhook delivery
  - `removeSecret` boolean — Whether to clear the webhook secret
  - `webhookSecret` string — Optional: new webhook secret (if not provided, existing secret is unchanged)

## Response `200`

OK

- ProtosNotificationWebhooksV1UpdateNotificationWebhookResponse
  - `webhook` ProtosNotificationWebhooksV1NotificationWebhook
    - `id` string — The notification webhook ID
    - `name` string — The user-specified name for the webhook
    - `url` string — The URL endpoint where webhook payloads will be sent
    - `hasSecret` boolean — Whether the webhook has a secret configured (actual secret never exposed)
    - `useNetworkBroker` boolean — Whether to use the network broker for webhook delivery

---

[API](https://skmtc.net/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.net/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/versions/6483eeecd582/schema)