Rotar el secreto de un webhook
Genera un secreto nuevo y deja de firmar con el anterior, también las entregas pendientes. El secreto nuevo se devuelve únicamente en esta respuesta: guardalo.
No admite Idempotency-Key: el header se rechaza con 400 idempotency-not-supported.
Cada llamada genera un secreto distinto; si no recibiste la respuesta, volvé a rotar.
Authorization
apiKey API key de Sifende en el header Authorization: Bearer {api-key}.
Además de autenticar, fija el contribuyente emisor y un ambiente inmutable DEV, PROD o
SANDBOX: por eso ninguno de los dos se envía en el body.
En PROD, la clave requiere un plan que incluya la API de integración; si no, toda ruta
responde 403 plan-operation-not-allowed.
In: header
Path Parameters
Identificador del webhook, tal como lo devuelve el listado
int64Response Body
application/json
application/json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/v1/contribuyente/webhooks/42/rotar"rotado
{ "endpoint": { "id": 42, "url": "https://erp.ejemplo.com.py/sifende/webhook", "ambiente": "PROD", "eventos": [ "documento.aprobado", "documento.rechazado" ], "activo": true, "fechaCreacion": "2026-10-20T14:03:11Z", "fechaEdicion": "2026-10-20T14:03:11Z", "fechaRotacionSecreto": "2026-10-20T14:03:11Z" }, "secreto": "whsec_8Kq2m5N0vXrT1bYc3LdWz9AeJfHpU4sG"}