# Alterar um webhook (rotacionar o secret, mudar eventos…)

> Endpoint PATCH /webhooks/{id} da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.

URL: https://docs.proteside.com/pt-BR/docs/api/reference/webhooks/updateWebhook

## Método e rota

`PATCH /webhooks/{id}`

## Parâmetros

- `id` (path, `string`, obrigatório)
- `org_id` (query, `string`): Somente parceiros (`orgs:manage`): atua sobre esta organização filha. Também pode ser enviado como `org_id` em corpos JSON.

## Corpo da requisição

- `url` (`string`)
- `secret` (`string`): Rotaciona o segredo de assinatura
- `name` (`string`)
- `events` (`array,null`)
- `min_severity` (`"critical" | "high" | "medium" | "low" | "info"`)
- `active` (`boolean`)

## Respostas

- `200`: Webhook
- `404`: Não encontrado na organização em que se está atuando

Especificação OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
