remove_hook
Removes an inbound webhook so its address stops answering; retries are idempotent. Use it to deactivate a deployed app's hook without clearing its signing secret.
Instructions
Remove an inbound webhook; its address stops answering. Idempotent.
The signing secret stays set (remove it with ``remove_secret``). A
webhook still declared in nerdit.toml comes back with a NEW address on
the next deploy.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"hook_name": "<hook_name>"
},
"name": "remove_hook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name (or row id) of an existing deployed app — only kind 'service' can be exposed: ``share_service``/``add_domain`` refuse a model or database with 422 ``*.kind_unsupported``, while the remove tools just find nothing to undo. | |
| hook_name | Yes | Webhook name: lowercase letters, digits and '-', 1-32 characters, starting with a letter (e.g. ``stripe``); maps to ``NERDIT_HOOK_<NAME>_SECRET`` and ``NERDIT_HOOK_<NAME>_URL``. | |
| idempotency_key | No | Caller-chosen key: a retry with the same key replays the first result instead of acting twice. Omit and a fresh key is minted per call, so each call acts. |