# `bird whatsapp agents delete`

## Usage

```bash
bird whatsapp agents delete <number-id> [flags]
```

## Description

Remove the agent from its number, so nothing answers contacts there automatically any more. Its questions, websites, files, skills and allowlist go with it, so read anything worth keeping first. The number itself keeps sending and receiving. Turn the agent off instead to pause it and keep what it knows.

This is destructive and cannot be undone; pass --yes to confirm.

## Examples

```bash
bird whatsapp agents delete <id> --yes
```

## Options

#### Safety

| Name                | Description                                                    |
| ------------------- | -------------------------------------------------------------- |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice   |
| `--yes`             | Confirm a destructive action (required; the CLI never prompts) |

## Related

| Name                                                                        | Description                                  |
| --------------------------------------------------------------------------- | -------------------------------------------- |
| [`bird whatsapp agents create`](/docs/cli/reference/whatsapp-agents-create) | Onboard an agent on a WhatsApp number        |
| [`bird whatsapp agents get`](/docs/cli/reference/whatsapp-agents-get)       | Get a WhatsApp number's agent                |
| [`bird whatsapp agents list`](/docs/cli/reference/whatsapp-agents-list)     | List WhatsApp numbers with their agent state |
| [`bird whatsapp agents test`](/docs/cli/reference/whatsapp-agents-test)     | Send an agent a test message                 |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)