Webhooks

Rota el secreto de firma con ventana de solapamiento

Genera un secreto nuevo con ventana de solapamiento: durante un rato los dos son válidos, así que puedes desplegar el nuevo sin perder entregas. Es la diferencia con el webhook entrante, donde rotar invalida el anterior de inmediato.

post/webhook-endpoints/{id}/rotate-secret

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/webhook-endpoints/{id}/rotate-secret
  • 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

overlap_hoursnumber

Cuántas horas sigue siendo válido el secreto ANTERIOR. Durante esa ventana cada entrega viaja firmada con los dos —dos v1 en X-Met-Signature— y tu verificación pasa con cualquiera de ellos.

0 = sin ventana: el secreto viejo deja de valer en el acto. Es lo que se quiere cuando el secreto se filtró, no cuando estás haciendo higiene.

Example request

{
  "overlap_hours": 24
}

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",
    "secret": "whsec_9Bq1s0YkV2m4Xz7pL3nR8tGh",
    "status": "active",
    "url": "https://tu-app.com/hooks/meteor"
  }
}

Changes

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