Rotasi secret endpoint

Membuat signing secret baru. Secret sebelumnya tetap berlaku selama satu hari.

POST/v1/webhook-endpoints/{id}/rotate-secret

Membutuhkan izin webhooks:write.

Parameter path

idstringwajib

Id endpoint (whk_…).

Contoh: whk_01k7q3m8x2v5t9n4b6c1d0e7fa

Diawali whk_.

Respons (200)

dataobjectwajib

Objek yang dikembalikan, atau array objek untuk operasi daftar.

secretstringwajib

Secret penandatanganan, whsec_…. Hanya ada di jawaban ini: simpan sekarang.

Contoh: whsec_k3f9…

previous_secret_retires_atstringwajib

Kapan secret lama berhenti menandatangani, sehari setelah rotasi.

Contoh: 2026-10-26T03:04:05.000Z

Format: date-time

metaobjectwajib

Detail request seperti id dan kursor paginasi.

request_idstringwajib

Id request ini. Sebutkan saat bertanya ke dukungan.

Contoh: req_Hy3k9QzT2LmN8vXa

Request yang gagal dijawab dengan bentuk error yang sama; lihat Error.

Request
Respons

curl -X POST "https://api.baiyar.com/v1/webhook-endpoints/{id}/rotate-secret" \
  -H "Authorization: Bearer $BAIYAR_KEY"

{
  "data": {
    "secret": "whsec_k3f9…",
    "previous_secret_retires_at": "2026-10-26T03:04:05.000Z"
  },
  "meta": {
    "request_id": "req_Hy3k9QzT2LmN8vXa"
  }
}