Ingresar
DocumentaciónGuíasReferenciaWebhooksRecursos
Destinos de alertas

Actualizar un destino de alertas

Sirve para renombrar un destino de alertas o, si es un webhook, corregir su URL; cambiar la URL obliga a verificarlo de nuevo.

PATCH
/alerts/destinations/{id}

Escritura · requiere el permiso accounts:write.

La URL de un phone sigue siendo de solo lectura post-creacion (se verifica por OTP contra ese numero; cambiarlo seria crear otro destino). Para un webhook se permite corregirla, y esa es justamente la razon por la que el guard anti-SSRF tiene que correr TAMBIEN aca: si solo corriera en el alta, editar seria la puerta de atras para dejar persistida una URL que apunta a la red interna.

Cambiar la URL resetea verified_at: lo que se verifico fue un endpoint concreto, no el registro.

Returns 404 for both non-existent and other-owner destinations to prevent resource-existence enumeration by unauthenticated/unauthorized callers.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

id*integer

Cuerpo del pedido

application/json
  1. body
name?|

name is nullable per schema — allow sending null to clear the field.

Largolength <= 120
destination?string

destination solo se acepta para destinos webhook (el controller rechaza el resto con 422). La forma real —https y que resuelva a una IP publica— la decide SsrfGuard en el controller, no una regla de validacion: el guard resuelve DNS, y eso no se expresa con url/starts_with.

Largolength <= 255

Cuerpo de la respuesta

application/json
  1. response
curl -X PATCH "https://example.com/alerts/destinations/0" \  -H "Content-Type: application/json" \  -d '{}'
{}

Crear un destino de alertas POST

Usalo para sumar un teléfono o un webhook HTTPS que reciba tus alertas operativas. Después hay que verificarlo; si es un webhook, guardá el secreto de firma, que se muestra una sola vez.

Eliminar un destino de alertas DELETE

Usalo para dejar de enviar alertas a un teléfono o webhook; se borran también sus configuraciones de alertas.