Webhooks

Actualiza un webhook endpoint (eventos, URL o descripción) sin cambiar el secreto

Cambia a qué eventos está suscrito el endpoint, su URL o su descripción. El secreto de firma no cambia: tu verificación sigue funcionando igual. enabled_events reemplaza la lista completa —para sumar un evento, manda la lista actual más el nuevo—. Manda al menos un campo. No reactiva un endpoint apagado por fallos.

patch/webhook-endpoints/{id}

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/webhook-endpoints/{id}
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Path parameters

idstring required

ID del recurso de esta ruta.

Request body

descriptionstring nullable

Etiqueta libre para distinguirlo en el listado. null la borra.

enabled_eventsstring[]

La lista COMPLETA de eventos que quieres recibir desde ahora (reemplaza la anterior). * es el comodín «todos, incluidos los que se agreguen después». task.completed está deprecado: no se emite desde el 2026-08-31 y sale del catálogo el 2027-04-07.

urlstring uri

Nueva URL de entrega. Debe traer protocolo (https://…).

Example request

{
  "description": "Producción",
  "enabled_events": [
    "contact.message.received",
    "contact.message.sent",
    "contact.message.failed"
  ],
  "url": "https://tu-app.com/hooks/meteor"
}

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "created_at": "2026-07-30T04:12:33.120Z",
    "description": "Producción",
    "disabled_reason": "Apagado automático: 3 entregas seguidas agotaron todos sus intentos sin una sola respuesta correcta desde 2026-08-27 04:10 UTC.",
    "enabled_events": [
      "run.completed",
      "contact.created"
    ],
    "id": "b3f1c9a2-6d4e-4f88-9a01-2c7e5d3b1f40",
    "last_delivery_at": "2026-07-30T05:01:12.000Z",
    "object": "webhook_endpoint",
    "previous_secret_expires_at": "2026-08-31T05:01:12.000Z",
    "status": "active",
    "url": "https://tu-app.com/hooks/meteor"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.