lua webhooks manages the webhooks defined with LuaWebhook and pushed with lua push webhook: it lists them, makes a pushed version live, turns a webhook on or off, deletes it, and subscribes it to platform events. Every action runs against production and takes effect for the next request.
Verified against lua-cli 3.33.0.
Synopsis
Description
With no action the command opens a menu coveringview, versions, deploy, activate, deactivate, and delete. list-events, subscribe, and unsubscribe exist only as arguments.
view lists every webhook in lua.skill.yaml with its ID, whether a version is deployed, and when. It does not print the webhook’s URL.
versions prints a pointer to lua version list: per-primitive history is managed by agent versions.
deploy makes one pushed version live without a confirmation prompt. It is the same operation as lua deploy webhook --name <name> --set-version <ver> --force; lua deploy also records the deployed version in lua.skill.yaml and reports the agent version it promoted.
activate and deactivate turn the webhook on or off without changing its version. A deactivated webhook stops receiving requests until you activate it again.
delete removes the webhook from the server. A webhook that has pushed versions is deactivated instead of deleted and stays in lua.skill.yaml until you remove it. delete also resolves webhooks that exist only on the server.
list-events prints the platform events a webhook can subscribe to. The catalog is fixed by the installed CLI: message.received, message.sent, message.delivered, message.read, message.failed, message.played. subscribe adds one event to the webhook’s subscriptions on the server and unsubscribe removes it; both are no-ops with exit 0 when the subscription is already in the requested state, and both refuse an event outside the catalog. What each event carries is described in About webhooks.
--webhook-name matches the name or the ID. Every form needs a project directory and a credential.
Arguments
Accepted spellings:
show, info → view; list-versions, history → versions; publish → deploy; on, enable → activate; off, disable → deactivate; rm, remove, del → delete; events, list_events → list-events; sub → subscribe; unsub → unsubscribe.
Options
Examples
List the webhooks and whether each is deployed.Output
Output
Exit codes
The full table is in Errors and exit codes.
See also
LuaWebhook— define a webhook, including its signing secret- Handle a webhook
lua triggers— paste-anywhere URLs that wake the agentlua integrations— integration webhooks from connected SaaSlua logs—--type webhook --name <name>