> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar un webhook

> Actualiza la URL de callback o activa/desactiva un endpoint de webhook existente enviando su webhookId como parámetro de ruta en la solicitud.

Usa este endpoint para modificar un webhook existente. Puedes actualizar la URL de callback, cambiar el estado para desactivar o volver a activar la entrega, o ambas cosas al mismo tiempo. El `webhookId` se envía como parámetro de ruta de la URL. Los cambios surten efecto de inmediato: desactivar un webhook detiene la entrega de eventos hasta que lo vuelvas a activar. Los eventos que ocurren mientras el webhook está desactivado no se ponen en cola y no se envían después de que lo vuelvas a activar. Un webhook eliminado no se puede actualizar.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` y `Content-Type: application/json`.

## Endpoint

`PUT https://api.velafi.com/v2/webhook/{webhookId}`

## Parámetro de ruta

**webhookId** `string` *required*

ID único del webhook que se actualizará. Lo obtienes de la respuesta de [Crear webhook](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints.md) o de [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md).

## Parámetros de la solicitud

**url** `string`

Opcional. La nueva URL de callback de este webhook. Debe comenzar con `http`. Si se omite, la URL no cambia.

**status** `number`

Opcional. Estado actualizado del webhook: `10` = activo, `20` = desactivado. `30` se rechaza; usa [Eliminar webhook](https://docs.velafi.com/es/api-reference/webhooks/delete-a-webhook.md) en su lugar. Si se omite, el estado no cambia.

## Campos de la respuesta

**code** `number`

Código de respuesta de tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `object`

**Campos de data**

**webhookId** `string`

ID del webhook actualizado.

**eventType** `string`

Tipo de evento para el que está registrado este webhook (sin cambios).

**url** `string`

La URL de callback actualizada.

**status** `number`

Estado actualizado: `10` = activo, `20` = desactivado, `30` = eliminado.

**publicKey** `string`

Clave pública RSA codificada en Base64 para verificar las firmas del webhook (sin cambios).

## Ejemplo

```bash cURL theme={null}
curl -X PUT https://api.velafi.com/v2/webhook/ebab8a9663704e7cbbebe672c7c67912 \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/velafi-v2",
    "status": 10
  }'
```

```json Respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "webhookId": "ebab8a9663704e7cbbebe672c7c67912",
    "eventType": "ORDER_WEBHOOK",
    "url": "https://your-app.com/webhooks/velafi-v2",
    "status": 10,
    "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAp/6GRTIrl+kQb9u27cGz..."
  }
}
```

> [!NOTE]
>
> No puedes cambiar el `eventType` de un webhook existente. Para escuchar otro evento, crea un webhook nuevo y elimina el anterior.


## Related topics

- [Eliminar un webhook](https://docs.velafi.com/es/api-reference/webhooks/delete-a-webhook.md)
- [Crear un webhook](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints.md)
- [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Webhooks](https://docs.velafi.com/es/docs/guides/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.