# Transport

URL: https://docs.hanzo.ai/docs/cli/transport

> The `hanzo transport` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/transport) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/transport) · [SDKs](https://docs.hanzo.ai/docs/sdks)

One inbox for the chat apps you connect — Discord, Slack, Teams, Telegram.

[API reference →](https://docs.hanzo.ai/docs/openapi/transport)

```bash
hanzo transport list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                            | What it does                                                                                                                                                                                       |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo transport inbox`            | Returns the caller's own messages to the org's connected chat bots — those recorded on the caller's linked account — oldest first, in the portable envelope shape every transport normalises into. |
| `hanzo transport list`             | Reports every chat transport this org can send through, and whether it can send through it right now.                                                                                              |
| `hanzo transport send <transport>` | Send a message from your org's bot to one chat channel                                                                                                                                             |

### Agent

| Command                         | What it does                                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `hanzo transport agent get`     | Returns which agent answers the caller org's transport: the default and every channel bound to another agent. |
| `hanzo transport agent replace` | Binds agents to the caller org's transport and answers the bindings as GET would.                             |

### Allowlist

| Command                             | What it does                                                                                                                                                                                                                                                                                                     |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo transport allowlist get`     | Returns the caller org's access policy for one transport: whether DMs are pairing-gated, allowlisted or open, whether group channels are open, allowlisted or disabled, the config-managed DM and group allow entries, the senders approved through PAIRING (read-only here), and the org's named access groups. |
| `hanzo transport allowlist replace` | Edits the caller org's access policy for one transport and answers the policy as GET would, so both verbs return ONE shape.                                                                                                                                                                                      |

### Pairing

| Command                           | What it does                                                                                                                                                                             |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo transport pairing approve` | Turns one pending pairing code into a standing allow entry, so that person can DM the org's bot on that transport from now on.                                                           |
| `hanzo transport pairing get`     | Returns the pairing requests waiting for the caller org to approve — one per person who messaged a connected bot on a transport whose DM policy is "pairing" and who is not allowed yet. |
