Webhook 生命週期與恢復

active 且 enabled 的 webhook 才會接受通過驗證的 inbound 事件。自動保護機制可能把資料列狀態設成 paused；可用 arinova.webhook.update_webhook 傳入 status: active 恢復，恢復時會清除暫停時間與原因。update 不提供由使用者主動把 webhook 設為 paused 的操作。Update 與 cancellation 都要求此 Agent 的 per-Webhook write grant；拒絕刻意回 resource_not_found。

enabled: false 只會停用接收，不等於取消，可再透過 update 改回。expiresAt 是另一個時間閘門：超過時間後，inbound 會得到 expired/gone 結果；要修改或清除到期時間，同樣使用 update 的 expiresAt。

arinova.webhook.cancel_webhook 是需要確認、strict drift 的 soft cancellation。它會保存 status: cancelled 與 paused_reason: user_cancelled，重複取消是安全的。取消後資料仍保留供稽核，但不能再 update 或 resume；若要重新接收，必須建立新的 webhook。

因此 paused、disabled、cancelled、expired 不可混為一談。只有可恢復的 paused 或 disabled 入口適合重新啟用；提出生命週期操作前，先以 arinova.webhook.get_webhook 確認目前狀態。Owner 在 Office > Incoming Webhooks 管理 grants 與生命週期。Office Agent 也可能把 Webhook 當 collaboration context；terminal Webhook 可繼續用來解釋歷史或重建方式，但不能 resume 或 mutate。

Related actions

arinova.webhook.get_webhook, arinova.webhook.update_webhook, arinova.webhook.cancel_webhook

Also known as

webhook 狀態, active, paused, cancelled, expired, 取消 webhook, 恢復 webhook

---

Machine-readable Markdown · Knowledge index