> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tai hooks

> Register and inspect webhook hooks.

Register and inspect webhook hooks.

```console theme={null}
$ tai hooks [OPTIONS] COMMAND [ARGS]...
```

## `tai hooks delete`

Unregister a hook by name.

Example: `tai hooks delete h1`

```console theme={null}
$ tai hooks delete [OPTIONS] NAME
```

| Argument | Description             |
| -------- | ----------------------- |
| `NAME`   | Hook name. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai hooks delete-verifier`

Remove a topic's verifier binding.

Example: `tai hooks delete-verifier github`

```console theme={null}
$ tai hooks delete-verifier [OPTIONS] TOPIC
```

| Argument | Description              |
| -------- | ------------------------ |
| `TOPIC`  | Hook topic. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai hooks list`

List registered hooks (and the per-topic verifier bindings under `--json`).

Example: `tai hooks list --topic github`

```console theme={null}
$ tai hooks list [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--topic` `TEXT`       | Filter to one topic.                   |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai hooks register`

Register a hook from a HookParams JSON body.

Example: `tai hooks register --params '{"name":"h1","topic":"github","tool":"notify"}'`

```console theme={null}
$ tai hooks register [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--params` `TEXT`      | The full HookParams as a JSON object.  |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai hooks set-verifier`

Bind a webhook verifier to a topic so its deliveries are signature-verified.

Example: `tai hooks set-verifier github --verifier github_hmac`

```console theme={null}
$ tai hooks set-verifier [OPTIONS] TOPIC
```

| Argument | Description              |
| -------- | ------------------------ |
| `TOPIC`  | Hook topic. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--verifier` `TEXT`    | Registered webhook-verifier name.      |
| `--config` `TEXT`      | Verifier config as a JSON object.      |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai hooks verifiers`

List the registered webhook-verifier names (the bind catalog).

Example: `tai hooks verifiers`

```console theme={null}
$ tai hooks verifiers [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |