Saltar al contenido principal
PATCH
Modifica un webhook. Envía solo los campos que quieras cambiar. Envía status: "enabled" para volver a activar un webhook desactivado. Consulta Avisos de fallo.
Requiere el scope webhooks_manage.

Solicitud

Parámetros de ruta

string
requerido
Identificador del webhook (UUID).

Parámetros del cuerpo

string
Nueva URL HTTPS. Mismas reglas que en Crear.
string[]
Nueva lista de tipos de evento. Sustituye a la lista anterior.
string[]
Nueva lista de 1 a 5 direcciones. Sustituye a la lista anterior.
string
Nueva descripción, de 500 caracteres como máximo. null la borra.
string
enabled o disabled. Desactivarlo cancela las entregas pendientes.

Respuesta

Si la petición tiene éxito, la API devuelve 200 OK con el webhook actualizado.
string
requerido
Identificador del webhook (UUID).
string
requerido
La URL HTTPS a la que Aniva envía los eventos.
string
Texto libre para tu propia referencia. Puede ser null.
string[]
requerido
Tipos de evento que recibe este webhook. * significa todos los tipos.
string[]
requerido
Direcciones a las que Aniva envía un correo cuando las entregas siguen fallando.
string
requerido
enabled o disabled.
string
Instante ISO 8601 UTC en el que se desactivó el webhook. null mientras esté activado.
string
Motivo por el que se desactivó el webhook. Consulta Avisos de fallo. null mientras esté activado.
string
Instante ISO 8601 UTC en el que empezó la racha actual de fallos. null cuando la última entrega tuvo éxito.
string
Instante ISO 8601 UTC en el que el secreto anterior deja de firmar. null cuando no hay ninguna rotación en curso.
string
requerido
Instante ISO 8601 UTC en el que se creó el webhook.
string
requerido
Instante ISO 8601 UTC del último cambio.

Respuestas de error