---
title: "bird sms messaging-profiles delete"
description: "Delete an SMS messaging profile"
canonical: "https://bird.com/docs/cli/reference/sms-messaging-profiles-delete"
---

# `bird sms messaging-profiles delete`

## Usage

```bash
bird sms messaging-profiles delete <profile-id> [flags]
```

## Description

Delete a messaging profile and release its reply numbers so another profile can use them. Sends that name the profile are then refused, but sends and inbound attribution can keep using it for up to 60 seconds.

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

## Examples

```bash
bird sms messaging-profiles delete <id> --yes
```

## Options

#### Safety

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

#### Options

| Name        | Description                                              |
| ----------- | -------------------------------------------------------- |
| `--dry-run` | Print the resolved request without sending it, then exit |

## Related

| Name                                                                                      | Description                     |
| ----------------------------------------------------------------------------------------- | ------------------------------- |
| [`bird sms messaging-profiles create`](/docs/cli/reference/sms-messaging-profiles-create) | Create an SMS messaging profile |
| [`bird sms messaging-profiles get`](/docs/cli/reference/sms-messaging-profiles-get)       | Get an SMS messaging profile    |
| [`bird sms messaging-profiles list`](/docs/cli/reference/sms-messaging-profiles-list)     | List SMS messaging profiles     |
| [`bird sms messaging-profiles update`](/docs/cli/reference/sms-messaging-profiles-update) | Update an SMS messaging profile |

## 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)