# Alterar endpoint de webhook (/docs/conta-digital/endpoints/webhooks/put_webhook)

## PUT /transactions/webhooks/{webhookId}

`PUT https://api.hub.payzu.com.br/api/v1/transactions/webhooks/{webhookId}`

Escopo: `WEBHOOK_WRITE`. Troca a URL ou os eventos de um endpoint, ou o desativa e reativa. Envie ao menos um campo.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `webhookId` | string | yes | Identificador do endpoint. |

### Body params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `url` | string | no | Nova URL HTTPS pública. — format: uri; maxLength: 2048 |
| `events` | string[] | no | Nova lista de eventos. Ao menos um. |
| `isActive` | boolean | no | `false` para de enviar webhooks ao endpoint na hora. |

### Responses

**200** Endpoint alterado.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Identificador do endpoint. |
| `url` | string | yes | URL do endpoint. |
| `events` | string[] | yes | Eventos assinados. |
| `isActive` | boolean | yes | Se o endpoint recebe webhooks. |
| `createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `updatedAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |

**400** Requisição inválida.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**404** Não encontrado, ou de outra conta.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**409** Conflito com o estado atual.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**422** Recusa de regra de negócio.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |