# Delete Channel

> The **Delete Channel** activity calls the Microsoft Graph [DeleteChannel](https://docs.microsoft.com/en-us/graph/api/channel-delete?view=graph-rest-beta&tabs=http) API to delete a specified channel (**ChannelId**) from a team (**TeamId**).

## Overview

The **Delete Channel** activity calls the Microsoft Graph [DeleteChannel](https://docs.microsoft.com/en-us/graph/api/channel-delete?view=graph-rest-beta&tabs=http) API to delete a specified channel (**ChannelId**) from a team (**TeamId**).

## How It Works

The following steps and message sequence diagram is an example how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-setup#setup) steps.
2. Add the [Microsoft Teams Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-scope#microsoft-teams-scope) activity to your project.
3. Add an activity or run an external process that outputs a `Team.Id` value (e.g.,[Get Teams](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-teams#get-teams)) AND an activity or external process that outputs a `Channel.Id` value (e.g., [Get Channel](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-channel#get-channel)).
4. Add the **Delete Channel** activity inside the **Microsoft Teams Scope** activity.
5. Enter values for the [Input](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-delete-channel#input) properties.
6. Run the activity.
   * Your input property values are sent to the [DeleteChannel](https://docs.microsoft.com/en-us/graph/api/channel-delete?view=graph-rest-beta&tabs=http) API.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-35052-71e24b1d-03bef89a.webp)

## Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-34423-df96c789-d5d8348d.webp)

### Common

#### DisplayName

The display name of the activity.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *Delete Channel* |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

### Input

#### TeamId

The Id of the `Team` object that contains the channel you want to delete.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | To get the `Team.Id` value, use an external process or activity that includes the `Team.Id` value in its output (e.g., [Get Teams](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-teams#get-teams) or external API call) |

#### ChannelId

The Id of the `Channel` object that you want to delete.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | To get the `Channel.Id` value, use an external process or activity that includes the `Channel.Id` value in its output (e.g., [Get Channels](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-get-channels#get-channels) or external API call) |

### Misc

#### Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

## Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the [Quickstart](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-teams-quickstarts) guides.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-33655-12ac2793-e61968d7.webp)
