# `bird sms tfn verifications cancel`

## Usage

```bash
bird sms tfn verifications cancel <verification-id> [flags]
```

## Description

Cancels a draft verification and frees the toll-free number it held, so the number can be put on a new one. Only a draft can be canceled: once a verification has been submitted the carrier is holding it, and it is locked.

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

## Examples

```bash
bird sms tfn verifications cancel <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 sms tfn verifications create`](/docs/cli/reference/sms-tfn-verifications-create)             | Create a toll-free verification         |
| [`bird sms tfn verifications get`](/docs/cli/reference/sms-tfn-verifications-get)                   | Get a toll-free verification            |
| [`bird sms tfn verifications list`](/docs/cli/reference/sms-tfn-verifications-list)                 | List your toll-free verifications       |
| [`bird sms tfn verifications requirements`](/docs/cli/reference/sms-tfn-verifications-requirements) | Get what a toll-free verification needs |
| [`bird sms tfn verifications update`](/docs/cli/reference/sms-tfn-verifications-update)             | Update a toll-free verification         |